sync with en rev

Author: leonardolara

reference/strings/functions/setlocale.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 45042fef652f1b4e904e809fcbfcf31f6c60670b Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: 09324fb1df7b5b1c0a5f95e3ebbe802f59da4585 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.setlocale">
  <refnamediv>
   <refname>setlocale</refname>
@@ -11,7 +11,7 @@
   <methodsynopsis>
    <type class="union"><type>string</type><type>false</type></type><methodname>setlocale</methodname>
    <methodparam><type>int</type><parameter>category</parameter></methodparam>
-   <methodparam><type>string</type><parameter>locales</parameter></methodparam>
+   <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>locales</parameter></methodparam>
    <methodparam rep="repeat"><type>string</type><parameter>rest</parameter></methodparam>
   </methodsynopsis>
   <simpara>Assinatura alternativa (não suportada com argumentos nomeados):</simpara>
@@ -97,7 +97,7 @@
      <listitem>
       <para>
        Se <parameter>locales</parameter> for uma string vazia
-       <literal>""</literal>, os nomes de localidade serão definidos a partir dos
+       <literal>""</literal> ou &null;, os nomes de localidade serão definidos a partir dos
        valores das variáveis ​​de ambiente com os mesmos nomes das categorias
        acima, ou de "LANG".
       </para>
@@ -184,6 +184,21 @@ echo strftime("%A %e %B %Y", mktime(0, 0, 0, 12, 22, 1978));
 $loc_de = setlocale(LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge');
 echo "A localidade preferida para alemão neste sistema é '$loc_de'";
 ?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title>Recuperando a configuração atual de <function>setlocale</function></title>
+    <programlisting role="php" annotations="non-interactive">
+<![CDATA[
+<?php
+/* Recuperando a configuração atual */
+$current = setlocale(LC_ALL, null);
+
+echo "Localidade atual: '$current'";
+?>
 ]]>
     </programlisting>
    </example>