aidan Mon Sep 13 03:32:49 2004 EDT
Modified files:
/phpdoc/en/reference/strings/functions localeconv.xml
Log:
Added proper en_US array data (Derick's funny example uses odd characters, and the
actual description describes en_US, not nl)
Ensured the locale was checked first in the example
Added note about getting "127"
http://cvs.php.net/diff.php/phpdoc/en/reference/strings/functions/localeconv.xml?r1=1.7&r2=1.8&ty=u
Index: phpdoc/en/reference/strings/functions/localeconv.xml
diff -u phpdoc/en/reference/strings/functions/localeconv.xml:1.7
phpdoc/en/reference/strings/functions/localeconv.xml:1.8
--- phpdoc/en/reference/strings/functions/localeconv.xml:1.7 Mon Sep 13 03:22:29
2004
+++ phpdoc/en/reference/strings/functions/localeconv.xml Mon Sep 13 03:32:46
2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
<!-- splitted from ./en/functions/strings.xml, last change in rev 1.68 -->
<refentry id="function.localeconv">
<refnamediv>
@@ -133,6 +133,13 @@
</tgroup>
</informaltable>
</para>
+ <note>
+ <para>
+ A value of <literal>127</literal> for any of the elements means the
+ locale functionality is not implemented on your platform, the
+ specified locale does not exist or the category name is invalid.
+ </para>
+ </note>
<para>
The <literal>n_sign_posn</literal>, and <literal>n_sign_posn</literal> contain a
string
of formatting options. Each number representing one of the above listed
conditions.
@@ -142,8 +149,8 @@
should be grouped. For example, the grouping field for the en_US
locale, would contain a 2 item array with the values 3 and 3.
The higher the index in the array, the farther left the grouping
- is. If an array element is equal to CHAR_MAX, no further
- grouping is done. If an array element is equal to 0, the
+ is. If an array element is equal to <constant>CHAR_MAX</constant>,
+ no further grouping is done. If an array element is equal to 0, the
previous element should be used.
</para>
<example>
@@ -151,10 +158,10 @@
<programlisting role="php">
<![CDATA[
<?php
-setlocale(LC_ALL, '[EMAIL PROTECTED]');
-$locale_info = localeconv();
-
-print_r($locale_info);
+if (setlocale(LC_ALL, 'en_US')) {
+ $locale_info = localeconv();
+ print_r($locale_info);
+}
?>
]]>
</programlisting>
@@ -164,23 +171,25 @@
Array
(
[decimal_point] => .
- [thousands_sep] =>
- [int_curr_symbol] => EUR
- [currency_symbol] => €
- [mon_decimal_point] => ,
- [mon_thousands_sep] =>
+ [thousands_sep] => ,
+ [int_curr_symbol] => USD
+ [currency_symbol] => $
+ [mon_decimal_point] => .
+ [mon_thousands_sep] => ,
[positive_sign] =>
[negative_sign] => -
[int_frac_digits] => 2
[frac_digits] => 2
[p_cs_precedes] => 1
- [p_sep_by_space] => 1
+ [p_sep_by_space] => 0
[n_cs_precedes] => 1
- [n_sep_by_space] => 1
+ [n_sep_by_space] => 0
[p_sign_posn] => 1
- [n_sign_posn] => 2
+ [n_sign_posn] => 1
[grouping] => Array
(
+ [0] => 3
+ [1] => 3
)
[mon_grouping] => Array
@@ -193,9 +202,6 @@
]]>
</screen>
</example>
- <para>
- The constant CHAR_MAX is also defined for the use mentioned above.
- </para>
<para>
See also <function>setlocale</function>.
</para>
