betz Tue Jul 8 15:30:01 2003 EDT
Modified files:
/phpdoc/en/reference/strings/functions setlocale.xml
Log:
tips for windows added
win specific example
typos fixed
bugfix #24518
Index: phpdoc/en/reference/strings/functions/setlocale.xml
diff -u phpdoc/en/reference/strings/functions/setlocale.xml:1.10
phpdoc/en/reference/strings/functions/setlocale.xml:1.11
--- phpdoc/en/reference/strings/functions/setlocale.xml:1.10 Tue Jun 17 11:47:31
2003
+++ phpdoc/en/reference/strings/functions/setlocale.xml Tue Jul 8 15:30:01 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
<!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -->
<refentry id="function.setlocale">
<refnamediv>
@@ -66,8 +66,8 @@
categories, or from "LANG".
</para>
<para>
- If <parameter>locale</parameter> is zero or <literal>"0"</literal>, the locale
setting
- is not affected, only the current setting is returned.
+ If <parameter>locale</parameter> is &null; or <literal>"0"</literal>,
+ the locale setting is not affected, only the current setting is returned.
</para>
<para>
If <parameter>locale</parameter> is an array or followed by additional
@@ -83,7 +83,7 @@
</note>
<para>
Setlocale returns the new current locale, or &false; if the locale
- functionality is not implemented in the platform, the specified
+ functionality is not implemented on your platform, the specified
locale does not exist or the category name is invalid.
An invalid category name also causes a warning message. Category/locale
names can be found in <ulink url="&url.rfc;1766">RFC 1766</ulink>
@@ -96,6 +96,19 @@
what the system setlocale function returns.
</para>
</note>
+ <tip>
+ <para>
+ Windows users will find usefull information about
+ <parameter>locale</parameter> strings at Microsoft's msdn website.
+ Supported language strings can be found
+ <ulink url="&url.setlocale.lang.win32;">here</ulink> and supported
+ country/region strings <ulink url="&url.setlocale.country.win32;">
+ here</ulink>. Windows systems support the three letter codes for
+ country/region specified by <literal>ISO 3166-Alpha-3</literal>,which
+ can be found at this <ulink url="&url.iso-3166-3;">Unicode website
+ </ulink>.
+ </para>
+ </tip>
<para>
<example>
<title><function>setlocale</function> Examples</title>
@@ -110,6 +123,26 @@
/* try different possible locale names for german as of PHP 4.3.0 */
$loc_de = setlocale (LC_ALL, '[EMAIL PROTECTED]', 'de_DE', 'de', 'ge');
+echo "Preferred locale for german on this system is '$loc_de'";
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title><function>setlocale</function> Examples for Windows</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* Set locale to Dutch */
+setlocale (LC_ALL, 'nld_nld');
+
+/* Output: vrijdag 22 december 1978 */
+echo strftime ("%A %B %Y", mktime (0, 0, 0, 12, 22, 1978));
+
+/* try different possible locale names for german as of PHP 4.3.0 */
+$loc_de = setlocale (LC_ALL, '[EMAIL PROTECTED]', 'de_DE', 'deu_deu');
echo "Preferred locale for german on this system is '$loc_de'";
?>
]]>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php