From c7bc63cf9799acae35fc3d28346fcc18089e3571 Mon Sep 17 00:00:00 2001
From: Aidan Lister <aidan@php.net>
Date: Mon, 13 Sep 2004 07:32:46 +0000
Subject: [PATCH] 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"

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@168479 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/strings/functions/localeconv.xml | 42 ++++++++++++----------
 1 file changed, 24 insertions(+), 18 deletions(-)

diff --git a/reference/strings/functions/localeconv.xml b/reference/strings/functions/localeconv.xml
index 2e34be0046..4951eded5f 100644
--- a/reference/strings/functions/localeconv.xml
+++ b/reference/strings/functions/localeconv.xml
@@ -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, 'nl_NL.UTF-8@euro');
-$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 @@ print_r($locale_info);
 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 @@ Array
 ]]>
      </screen>
     </example>
-    <para>
-     The constant CHAR_MAX is also defined for the use mentioned above.
-    </para>
     <para>
      See also <function>setlocale</function>.
     </para>