Skip to content

Commit

Permalink
sync with en rev
Browse files Browse the repository at this point in the history
  • Loading branch information
leonardolara committed Nov 23, 2024
1 parent bc811ad commit c39f5b8
Show file tree
Hide file tree
Showing 4 changed files with 82 additions and 11 deletions.
26 changes: 23 additions & 3 deletions reference/bc/functions/bcdiv.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
<!-- EN-Revision: 1fafa3d9998bf7359b4edf39fcf49056b2006c1c Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
<refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>bcdiv</refname>
Expand Down Expand Up @@ -48,11 +48,25 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna o resultado da divisão como uma string, ou &null; se
<parameter>num2</parameter> é <literal>0</literal>.
Retorna o resultado da divisão como uma string.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
<simplelist>
<member><parameter>num1</parameter> ou <parameter>num2</parameter> não são string numéricas BCMath bem formadas</member>
<member><parameter>scale</parameter> está fora do intervalo válido</member>
</simplelist>
</para>
<simpara>
Esta função lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> se <parameter>num2</parameter>
for igual a <literal>0</literal>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand All @@ -70,6 +84,12 @@
<parameter>scale</parameter> pode ser null.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Dividir por 0 agora lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> ao invés de retornar null.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Expand Down
29 changes: 25 additions & 4 deletions reference/bc/functions/bcmod.xml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: ae Status: ready --><!-- CREDITS: rarruda -->
<!-- EN-Revision: 1fafa3d9998bf7359b4edf39fcf49056b2006c1c Maintainer: ae Status: ready --><!-- CREDITS: rarruda, leonardolara -->
<refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>bcmod</refname>
<refpurpose>Obtém o módulo de um número com precisão arbitrária</refpurpose>
<refpurpose>Obtém o resto de uma divisão com precisão arbitrária</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand Down Expand Up @@ -42,18 +42,33 @@
</para>
</listitem>
</varlistentry>
&bc.scale.description;
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna o módulo como uma string, ou &null; se
<parameter>num2</parameter> é <literal>0</literal>.
Retorna o resto como uma string.
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
<simplelist>
<member><parameter>num1</parameter> ou <parameter>num2</parameter> não são string numéricas BCMath bem formadas</member>
<member><parameter>scale</parameter> está fora do intervalo válido</member>
</simplelist>
</para>
<simpara>
Esta função lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> se <parameter>num2</parameter>
for igual a <literal>0</literal>.
</simpara>
</refsect1>

<refsect1 role="changelog"><!-- {{{ -->
&reftitle.changelog;
<informaltable>
Expand All @@ -71,6 +86,12 @@
<parameter>scale</parameter> pode ser null.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Dividir por 0 agora lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> ao invés de retornar null.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Expand Down
34 changes: 32 additions & 2 deletions reference/bc/functions/bcpow.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae -->
<!-- EN-Revision: e333514f66ae32a3468e05dbe64f55f01ff9451e Maintainer: ae Status: ready --><!-- CREDITS: rarruda,ae,leonardolara -->
<refentry xml:id="function.bcpow" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>bcpow</refname>
Expand Down Expand Up @@ -36,7 +36,7 @@
<term><parameter>exponent</parameter></term>
<listitem>
<para>
O número expoente, como uma string. Se o expoente for não inteiro, ele será truncado.
O número expoente, como uma string. Precisa ser um valor sem parte fracionária.
Os expoentes válidos dependem da plataforma, mas ao menos são válidos de
<literal>-2147483648</literal> até <literal>2147483647</literal>.
</para>
Expand All @@ -54,6 +54,22 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<para>
Esta função lança uma exceção <exceptionname>ValueError</exceptionname> nos seguintes casos:
<simplelist>
<member><parameter>num</parameter> ou <parameter>exponent</parameter> não são string numéricas BCMath bem formadas</member>
<member><parameter>scale</parameter> está fora do intervalo válido</member>
<member><parameter>exponent</parameter> tem uma parte fracionária</member>
</simplelist>
</para>
<simpara>
Esta função lança uma exceção <exceptionname>DivisionByZeroError</exceptionname> se <parameter>num</parameter>
for igual a <literal>0</literal> e <parameter>exponent</parameter> for um valor negativo.
</simpara>
</refsect1>

<refsect1 role="changelog"><!-- {{{ -->
&reftitle.changelog;
<informaltable>
Expand All @@ -65,6 +81,20 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Potências negativas de 0 anteriormente retornavam 0, mas agora lançam uma exceção
<exceptionname>DivisionByZeroError</exceptionname>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Quando <parameter>exponent</parameter> tem uma parte fracionária, lança uma exceção <exceptionname>ValueError</exceptionname>
ao invés de truncar o valor.
</entry>
</row>
<row>
<entry>7.3.0</entry>
<entry>
Expand Down
4 changes: 2 additions & 2 deletions reference/spl/splfileobject/setcsvcontrol.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 73007ad9889ca2a3d85b0a710b55deb44ac370cc Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: 61e2ab1eebc37f3a4abe54f05a9984001b7ce59f Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<refentry xml:id="splfileobject.setcsvcontrol" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>SplFileObject::setCsvControl</refname>
Expand All @@ -24,7 +24,7 @@
&reftitle.parameters;
<variablelist>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.fgetcsv')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='separator']]]/.)">
<xi:fallback/>
<xi:fallback><varlistentry><term>></term><listitem><simpara></simpara></listitem></varlistentry></xi:fallback>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.fgetcsv')/db:refsect1[@role='parameters']//db:varlistentry[db:term[db:parameter[text()='enclosure']]]/.)">
<xi:fallback/>
Expand Down

0 comments on commit c39f5b8

Please sign in to comment.