From: Marcus Boerger <helly@php.net>
Date: Fri, 19 Jan 2007 09:30:18 +0000 (+0000)
Subject: - Update
X-Git-Tag: RELEASE_1_0_0RC1~211
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0e4f124a1eb45b926dbfb3912f28a5a0d6b413d8;p=php

- Update
---

diff --git a/README.UNICODE-UPGRADES b/README.UNICODE-UPGRADES
index 797abf89d5..dba7fd3889 100644
--- a/README.UNICODE-UPGRADES
+++ b/README.UNICODE-UPGRADES
@@ -540,6 +540,27 @@ Unicode strings:
     zend_error(E_WARNING, "%v::__toString() did not return anything",
             Z_OBJCE_P(object)->name);
 
+Since [v]spprintf() can only output native strings there are also the new
+function [v]uspprintf() and [v]zspprintf() that create unicode strings and
+return the number of characters printed. That is they return the length rather 
+than the byte size. The second pair offunction also takes an additional type
+parameter that allows to create a string of arbitrary type. The following
+example illustrates the use. Assume it fetches a unicode/native string into
+path, path_len, path_type and then creates sub_name, sub_len and sub_type.
+
+	zstr path, sub_name;
+	int path_len, sub_len;
+	zend_uchar path_type, sub_type;
+
+	/* fetch */
+
+	if (path.v) {
+		sub_type = path_type;
+		sub_len = zspprintf(path_type, &sub_name, 0, "%R%c%s", 
+			path_type, path, 
+			DEFAULT_SLASH, 
+			entry.d_name);
+	}
 
 
 Upgrading Functions