sync with en rev

php · Dec 2, 2024 · 6b68ddc · 6b68ddc
1 parent 390a158
commit 6b68ddc
Show file tree

Hide file tree

Showing 2 changed files with 41 additions and 4 deletions.
diff --git a/reference/strings/functions/number-format.xml b/reference/strings/functions/number-format.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: de35b538453a7817a0cc839cddda0be46eed8764 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<!-- EN-Revision: ae148826a6830492a51e47f21e1ad4f80373f2a6 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <refentry xml:id="function.number-format" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>number_format</refname>
@@ -39,6 +39,11 @@
        Define o número de dígitos decimais.
        Se for igual a <literal>0</literal>, o separador de decimais definido por <parameter>decimal_separator</parameter> é
        omitido do valor de retorno.
+       A partir do PHP 8.3.0, quando o valor é negativo, <parameter>num</parameter>
+       é arredondado para o número de dígitos significativos informado em <parameter>decimals</parameter> antes
+       do separador de decimais.
+       Antes do PHP 8.3.0, valores negativos eram ignorados e manipulados como
+       se fossem <literal>0</literal>.
       </para>
      </listitem>
     </varlistentry>
@@ -81,6 +86,12 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.3.0</entry>
+       <entry>
+        Adicionada a manipulação de valores negativos para <parameter>decimals</parameter>.
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>
@@ -137,6 +148,32 @@ $english_format_number = number_format($number, 2, '.', '');
     </programlisting>
    </example>
   </para>
+  <example>
+   <title>Um valor negativo para <parameter>decimals</parameter></title>
+   <simpara>
+    A partir do PHP 8.3.0, um valor negativo para <parameter>decimals</parameter>
+    é usado para arredondar o número de dígitos significativos antes do separador
+    de decimais.
+   </simpara>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$number = "1234.5678";
+var_dump(number_format($number, -1));
+var_dump(number_format($number, -2));
+var_dump(number_format($number, -3));
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+string(5) "1,230"
+string(5) "1,200"
+string(5) "1,000"
+]]>
+   </screen>
+  </example>
  </refsect1>
 
  <refsect1 role="seealso">

diff --git a/reference/xsl/xsltprocessor.xml b/reference/xsl/xsltprocessor.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 42432109c9926f3b475c415c9e892dd6a7ba06ec Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 7532801ce307813e80a4b2f754b795b4263b7ffb Maintainer: leonardolara Status: ready -->
 <reference xml:id="class.xsltprocessor" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>A classe XSLTProcessor</title>
  <titleabbrev>XSLTProcessor</titleabbrev>
@@ -30,13 +30,13 @@
      <modifier>public</modifier>
      <type>bool</type>
      <varname linkend="xsltprocessor.props.doxinclude">doXInclude</varname>
-     <initializer>&false;</initializer>
+     <initializer>false</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>
      <type>bool</type>
      <varname linkend="xsltprocessor.props.clonedocument">cloneDocument</varname>
-     <initializer>&false;</initializer>
+     <initializer>false</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>