Skip to content

Commit 1044ed4

Browse files
leonardolaraleonardolara
committed
sync with en rev
1 parent 15f15cb commit 1044ed4

File tree

7 files changed

+95
-37
lines changed

7 files changed

+95
-37
lines changed

‎reference/bc/bcmath/number/round.xml

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: leonardolara Status: ready -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 15b93836d93f01ea6d90a68cacf04ce0d9fb8eff Maintainer: leonardolara Status: ready -->
22
<refentry xml:id="bcmath-number.round" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
33
<refnamediv>
44
<refname>BcMath\Number::round</refname>
@@ -25,11 +25,11 @@
2525
<variablelist>
2626
<!-- precision parameter -->
2727
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.round')/db:refsect1[@role='parameters']/descendant::db:varlistentry[2])" />
28-
<varlistentry>
28+
<varlistentry xml:id="bcmath-number.round..parameters.mode">
2929
<term><parameter>mode</parameter></term>
3030
<listitem>
3131
<simpara>
32-
Especifica o modo de arredondamento.
32+
Especifica o modo de arredondamento. Para mais informação sobre os modos, consulte <enumname>RoundingMode</enumname>.
3333
</simpara>
3434
</listitem>
3535
</varlistentry>

‎reference/bc/functions/bcround.xml

+2-9
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: a414ee95eb79e2c62c80827a46e15da5d15af97e Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 15b93836d93f01ea6d90a68cacf04ce0d9fb8eff Maintainer: leonardolara Status: ready -->
33
<refentry xml:id="function.bcround" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
44
<refnamediv>
55
<refname>bcround</refname>
@@ -27,14 +27,7 @@
2727
<variablelist>
2828
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.round')/db:refsect1[@role='parameters']/descendant::db:varlistentry[1])" />
2929
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.round')/db:refsect1[@role='parameters']/descendant::db:varlistentry[2])" />
30-
<varlistentry>
31-
<term><parameter>mode</parameter></term>
32-
<listitem>
33-
<simpara>
34-
Especifica o modo de arredondamento.
35-
</simpara>
36-
</listitem>
37-
</varlistentry>
30+
<xi:include xpointer="bcmath-number.round..parameters.mode" />
3831
</variablelist>
3932
</refsect1>
4033

‎reference/math/functions/round.xml

+65-3
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: f721489eaeb79ff096971fe5a5b101c2ebab8eeb Maintainer: ae Status: ready --><!-- CREDITS: marquesdanielb,ae,leonardolara -->
2+
<!-- EN-Revision: 15b93836d93f01ea6d90a68cacf04ce0d9fb8eff Maintainer: leonardolara Status: ready --><!-- CREDITS: marquesdanielb,ae,leonardolara -->
33
<refentry xml:id="function.round" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>round</refname>
@@ -11,7 +11,7 @@
1111
<type>float</type><methodname>round</methodname>
1212
<methodparam><type class="union"><type>int</type><type>float</type></type><parameter>num</parameter></methodparam>
1313
<methodparam choice="opt"><type>int</type><parameter>precision</parameter><initializer>0</initializer></methodparam>
14-
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>PHP_ROUND_HALF_UP</constant></initializer></methodparam>
14+
<methodparam choice="opt"><type class="union"><type>int</type><type>RoundingMode</type></type><parameter>mode</parameter><initializer>RoundingMode::HalfAwayFromZero</initializer></methodparam>
1515
</methodsynopsis>
1616
<para>
1717
Retorna um valor arredondado de <parameter>num</parameter> com a precisão especificada em
@@ -71,7 +71,7 @@
7171
<term><parameter>mode</parameter></term>
7272
<listitem>
7373
<para>
74-
Use uma das seguintes constantes para especificar o modo ao qual o arredondamento ocorre.
74+
Use <enumname>RoundingMode</enumname> ou uma das seguintes constantes a seguir para especificar o modo com o qual o arredondamento ocorre.
7575
<informaltable>
7676
<tgroup cols="2">
7777
<thead>
@@ -112,6 +112,7 @@
112112
</tbody>
113113
</tgroup>
114114
</informaltable>
115+
No entanto, observe que alguns modos novos adicionados existem apenas em <link linkend="enum.roundingmode">RoundingMode</link>.
115116
</para>
116117
</listitem>
117118
</varlistentry>
@@ -145,6 +146,12 @@
145146
</row>
146147
</thead>
147148
<tbody>
149+
<row>
150+
<entry>8.4.0</entry>
151+
<entry>
152+
Quatro novos modos de arredondamento foram adicionados.
153+
</entry>
154+
</row>
148155
<row>
149156
<entry>8.4.0</entry>
150157
<entry>
@@ -321,6 +328,61 @@ float(-1.5)
321328
]]>
322329
</screen>
323330
</example>
331+
<example>
332+
<title>Exemplo de uso de <enumname>RoundingMode</enumname></title>
333+
<programlisting role="php">
334+
<![CDATA[
335+
<?php
336+
foreach (RoundingMode::cases() as $mode) {
337+
foreach ([
338+
8.5,
339+
9.5,
340+
-3.5,
341+
] as $number) {
342+
printf("%-17s: %+.17g -> %+.17g\n", $mode->name, $number, round($number, 0, $mode));
343+
}
344+
echo "\n";
345+
}
346+
?>
347+
]]>
348+
</programlisting>
349+
&example.outputs;
350+
<screen role="php">
351+
<![CDATA[
352+
HalfAwayFromZero : +8.5 -> +9
353+
HalfAwayFromZero : +9.5 -> +10
354+
HalfAwayFromZero : -3.5 -> -4
355+
356+
HalfTowardsZero : +8.5 -> +8
357+
HalfTowardsZero : +9.5 -> +9
358+
HalfTowardsZero : -3.5 -> -3
359+
360+
HalfEven : +8.5 -> +8
361+
HalfEven : +9.5 -> +10
362+
HalfEven : -3.5 -> -4
363+
364+
HalfOdd : +8.5 -> +9
365+
HalfOdd : +9.5 -> +9
366+
HalfOdd : -3.5 -> -3
367+
368+
TowardsZero : +8.5 -> +8
369+
TowardsZero : +9.5 -> +9
370+
TowardsZero : -3.5 -> -3
371+
372+
AwayFromZero : +8.5 -> +9
373+
AwayFromZero : +9.5 -> +10
374+
AwayFromZero : -3.5 -> -4
375+
376+
NegativeInfinity : +8.5 -> +8
377+
NegativeInfinity : +9.5 -> +9
378+
NegativeInfinity : -3.5 -> -4
379+
380+
PositiveInfinity : +8.5 -> +9
381+
PositiveInfinity : +9.5 -> +10
382+
PositiveInfinity : -3.5 -> -3
383+
]]>
384+
</screen>
385+
</example>
324386
</para>
325387
</refsect1>
326388

‎reference/math/roundingmode.xml

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: e75557e268736a2a08a5cd17f50048e9db545e02 Maintainer: leonardolara Status: ready -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 15b93836d93f01ea6d90a68cacf04ce0d9fb8eff Maintainer: leonardolara Status: ready -->
22
<reference xmlns="http://docbook.org/ns/docbook" xml:id="enum.roundingmode" role="enum">
33
<title>A enumeração RoundingMode</title>
44
<titleabbrev>RoundingMode</titleabbrev>
@@ -9,7 +9,7 @@
99
<simpara>
1010
A enumeração <enumname>RoundingMode</enumname> é usada para especificar como o arredondamento
1111
deve ser realizado por <function>round</function>,
12-
<function>bcround</function> e <methodname>BCMath::round</methodname>.
12+
<function>bcround</function> e <methodname>BCMath\Number::round</methodname>.
1313
</simpara>
1414
</section>
1515

‎reference/pgsql/functions/pg-pconnect.xml

+16-13
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
2+
<!-- EN-Revision: 3b2503bdcbbffc9bd1381078ee06c298d4f8a49a Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
33
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.82 -->
44
<refentry xml:id="function.pg-pconnect" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
@@ -27,11 +27,14 @@
2727
<parameter>flags</parameter>.
2828
</para>
2929
<para>
30-
Para ativar a conexão persistente, a diretiva <link linkend="ini.pgsql.allow-persistent">pgsql.allow_persistent</link>
31-
no &php.ini; deve ser definida como &quot;On&quot; (que é o padrão).
32-
O número máximo de conexões persistentes pode ser definido com a diretiva <link linkend="ini.pgsql.max-persistent">pgsql.max_persistent</link>
33-
no &php.ini; (o padrão é -1 para nenhum limite). O número total
34-
de conexões pode ser definido com a diretiva <link linkend="ini.pgsql.max-links">pgsql.max_links</link>
30+
Para ativar a conexão persistente, a diretiva
31+
<link linkend="ini.pgsql.allow-persistent">pgsql.allow_persistent</link>
32+
no &php.ini; deve ser definida como <literal>"On"</literal> (que é o padrão).
33+
O número máximo de conexões persistentes pode ser definido com a diretiva
34+
<link linkend="ini.pgsql.max-persistent">pgsql.max_persistent</link>
35+
no &php.ini; (o padrão é <literal>-1</literal> para nenhum limite).
36+
O número total de conexões pode ser definido com a diretiva
37+
<link linkend="ini.pgsql.max-links">pgsql.max_links</link>
3538
no &php.ini;.
3639
</para>
3740
<para>
@@ -54,7 +57,7 @@
5457
do sinal de igual são opcionais. Para escrever um valor vazio ou
5558
contendo espaços, coloque-o entre aspas simples, por exemplo, <literal>palavra-chave =
5659
'um valor'</literal>. Aspas simples e barras invertidas dentro do valor devem ser
57-
escapadas com uma barra invertida, ou seja, \' e \\.
60+
escapadas com uma barra invertida, ou seja, <literal>\'</literal> e <literal>\\</literal>.
5861
</para>
5962
<para>
6063
As palavras-chave de parâmetro atualmente reconhecidas são:
@@ -63,8 +66,8 @@
6366
<parameter>password</parameter>, <parameter>connect_timeout</parameter>,
6467
<parameter>options</parameter>, <parameter>tty</parameter> (ignorada), <parameter>sslmode</parameter>,
6568
<parameter>requiressl</parameter> (descontinuada em favor de <parameter>sslmode</parameter>), e
66-
<parameter>service</parameter>. Quais desses argumentos existem depende
67-
da sua versão do PostgreSQL.
69+
<parameter>service</parameter>.
70+
Quais desses argumentos existem depende da sua versão do PostgreSQL.
6871
</para>
6972
</listitem>
7073
</varlistentry>
@@ -120,18 +123,18 @@
120123
<programlisting role="php">
121124
<![CDATA[
122125
<?php
126+
// Conecta a um banco de dados chamado "mary"
123127
$dbconn = pg_pconnect("dbname=mary");
124-
//conecta a um banco de dados chamado "mary"
125128
129+
// Conecta a um banco de dados chamado "mary" em "localhost" na porta "5432"
126130
$dbconn2 = pg_pconnect("host=localhost port=5432 dbname=mary");
127-
//conecta a um banco de dados chamado "mary" em "localhost" na porta "5432"
128131
132+
// Conecta a um banco de dados chamado "mary" no host "sheep" com usuário e senha
129133
$dbconn3 = pg_pconnect("host=sheep port=5432 dbname=mary user=lamb password=foo");
130-
//conecta a um banco de dados chamado "mary" no host "sheep" com usuário e senha
131134
135+
//Conecta a um banco de dados chamado "test" no host "sheep" com usuário e senha
132136
$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
133137
$dbconn4 = pg_pconnect($conn_string);
134-
//conecta a um banco de dados chamado "test" no host "sheep" com usuário e senha
135138
?>
136139
]]>
137140
</programlisting>

‎reference/shmop/functions/shmop-read.xml

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 81220ae76f6dcd6a562e4f38cb4cb6afb482db05 Maintainer: leonardolara Status: ready -->
33
<refentry xml:id="function.shmop-read" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>shmop_read</refname>
@@ -56,7 +56,7 @@
5656
<refsect1 role="returnvalues">
5757
&reftitle.returnvalues;
5858
<para>
59-
Retorna os dados&return.falseforfailure;.
59+
Retorna os dados.
6060
</para>
6161
</refsect1>
6262

‎reference/spl/arrayobject/construct.xml

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 0aa6447b9dcd8f0889d4d10ab37f69a5f48571f2 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto -->
2+
<!-- EN-Revision: 65c558143647fe63b8073180ba314067d5ea4b62 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto -->
33
<refentry xml:id="arrayobject.construct" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>ArrayObject::__construct</refname>
@@ -36,17 +36,17 @@
3636
<term><parameter>flags</parameter></term>
3737
<listitem>
3838
<para>
39-
Sinalizadores para controlar o comportamento do objeto <classname>ArrayObject</classname>.
40-
Veja <methodname>ArrayObject::setFlags</methodname>.
39+
Opções para controlar o comportamento do objeto <classname>ArrayObject</classname>.
40+
Consulte <methodname>ArrayObject::setFlags</methodname>.
4141
</para>
4242
</listitem>
4343
</varlistentry>
4444
<varlistentry>
4545
<term><parameter>iteratorClass</parameter></term>
4646
<listitem>
4747
<para>
48-
Especifique a classe que será usada para iteração do objeto <classname>ArrayObject</classname>.
49-
A classe deve estender a classe <classname>ArrayIterator</classname>.
48+
Especifica a classe que será usada para iteração do objeto <classname>ArrayObject</classname>.
49+
A classe deve ser um subtipo da classe <classname>ArrayIterator</classname>.
5050
</para>
5151
</listitem>
5252
</varlistentry>

0 commit comments

Comments
 (0)