Skip to content

Commit 9c9e92e

Browse files
leonardolaraleonardolara
committed
sync with en rev
1 parent 86b6a80 commit 9c9e92e

File tree

13 files changed

+210
-25
lines changed

13 files changed

+210
-25
lines changed

‎language-snippets.ent

+6-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 3295741565f760edd22e305bd10e37f243e9e194 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
2+
<!-- EN-Revision: 592e10fe7c16ddd3dc1c99f16f7bb1823e9f5b68 Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->
33

44
<!ENTITY installation.enabled.disable 'Esta extensão está habilitada por padrão. Ela pode ser desabilitada usando a seguinte opção em tempo de compilação: '>
55

@@ -3235,6 +3235,11 @@ local: {
32353235
<entry>string</entry>
32363236
<entry>Opcional. Servidor com porta opcional.</entry>
32373237
</row>
3238+
<row>
3239+
<entry>delegated</entry>
3240+
<entry>bool</entry>
3241+
<entry>Opcional. Se verdadeira, esta chave deve ser descriptografada pelo servidor KMIP.</entry>
3242+
</row>
32383243
</tbody>
32393244
</tgroup>
32403245
</table>

‎language/predefined/generator/rewind.xml

+86-4
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 8fee3ae9715ffa15922469eb7d98f4878917a6ee Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
2+
<!-- EN-Revision: 285d4ca5804f106ed3e19d4b0270819b8d38a74b Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,ae,leonardolara -->
33
<refentry xml:id="generator.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<refnamediv>
55
<refname>Generator::rewind</refname>
6-
<refpurpose>Reinicia o iterador</refpurpose>
6+
<refpurpose>Retrocede o gerador para o primeiro "yield"</refpurpose>
77
</refnamediv>
88

99
<refsect1 role="description">
@@ -13,9 +13,19 @@
1313
<void/>
1414
</methodsynopsis>
1515
<para>
16-
Se uma iteração já tiver sido inicializada, lançará uma exceção.
16+
O método retrocede o gerador para o ponto antes do primeiro &yield;.
17+
Se o gerador não estiver em uma primeira expressão &yield; quando este método é chamado,
18+
ele primeiramente irá avançar para a primeira expressão &yield; antes de retroceder.
19+
Se o gerador já estiver no ponto de início do segundo yield,
20+
uma exceção <classname>Exception</classname> será lançada.
1721
</para>
18-
22+
<note>
23+
<para>
24+
Este é o <emphasis>primeiro</emphasis> método chamado ao iniciar um
25+
laço &foreach;. Ele <emphasis>não</emphasis> será
26+
executado <emphasis>após</emphasis> os laços &foreach;.
27+
</para>
28+
</note>
1929
</refsect1>
2030

2131
<refsect1 role="parameters">
@@ -30,6 +40,78 @@
3040
</para>
3141
</refsect1>
3242

43+
<refsect1 role="examples">
44+
&reftitle.examples;
45+
<para>
46+
<example>
47+
<title>Exemplo de <methodname>Generator::rewind</methodname></title>
48+
<programlisting role="php">
49+
<![CDATA[
50+
<?php
51+
52+
function generator(): Generator
53+
{
54+
echo "Eu sou um gerador!\n";
55+
56+
for ($i = 1; $i <= 3; $i++) {
57+
yield $i;
58+
}
59+
}
60+
61+
// Inicializa o gerador
62+
$generator = generator();
63+
64+
// Retrocede o gerador para o início da primeira expressão yield,
65+
// se já não estava lá
66+
$generator->rewind(); // Eu sou um gerador!
67+
68+
// Nada acontece aqui. O gerador já está retrocedido.
69+
$generator->rewind(); // Sem saída (NULL)
70+
71+
// Isto retrocede o gerador para a primeira expressão yield,
72+
// se já não estava lá, e itera sobre o gerador.
73+
foreach ($generator as $value) {
74+
// Após gerar o primeiro valor, o gerador permanece na
75+
// primeira expressão yield até que continue a execução e avance ao próximo yield
76+
echo $value, PHP_EOL; // 1
77+
78+
break;
79+
}
80+
81+
// Continua e retrocede novamente. Nenhum erro ocorre porque o gerador não avançou além do primeiro yield
82+
$generator->rewind();
83+
84+
echo $generator->current(), PHP_EOL; // 1
85+
86+
// Nenhum erro ocorre, o gerador ainda está no primeiro yield
87+
$generator->rewind();
88+
89+
// Isto avança o gerador para a segunda expressão yield
90+
$generator->next();
91+
92+
try {
93+
// Aqui uma Exception é lançada
94+
// porque o gerador já avançou para o segundo yield
95+
$generator->rewind(); // Fatal error: Uncaught Exception: Cannot rewind a generator that was already run
96+
} catch (Exception $e) {
97+
echo $e->getMessage();
98+
}
99+
100+
?>
101+
]]>
102+
</programlisting>
103+
&example.outputs;
104+
<screen>
105+
<![CDATA[
106+
Eu sou um gerador!
107+
1
108+
1
109+
Cannot rewind a generator that was already run
110+
]]>
111+
</screen>
112+
</example>
113+
</para>
114+
</refsect1>
33115

34116
</refentry>
35117
<!-- Keep this comment at the end of the file

‎reference/dom/domxpath/registerphpfunctionns.xml

+4-3
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: db4a10ffdc22db3b49ea7fc01c36d21180c339b8 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<!-- EN-Revision: 647105f8c23ce0b22e1b749d7cd8e00cdeade619 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
33
<refentry xml:id="domxpath.registerphpfunctionns" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
44
<refnamediv>
55
<refname>DOMXPath::registerPhpFunctionNS</refname>
@@ -69,6 +69,7 @@
6969
<programlisting role="php">
7070
<![CDATA[
7171
<?php
72+
7273
$xml = <<<EOB
7374
<books>
7475
<book>
@@ -87,15 +88,15 @@ $xml = <<<EOB
8788
</books>
8889
EOB;
8990
90-
$doc = new DOMDocument;
91+
$doc = new DOMDocument();
9192
$doc->loadXML($xml);
9293
9394
$xpath = new DOMXPath($doc);
9495
9596
// Registra o namespace my: (obrigatório)
9697
$xpath->registerNamespace("my", "urn:my.ns");
9798
98-
// Registra funções PHP (sem restrições)
99+
// Registra função PHP
99100
$xpath->registerPhpFunctionNS(
100101
'urn:my.ns',
101102
'substring',

‎reference/mongodb/mongodb/driver/bulkwrite/update.xml

+26-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 734bafeaf071b78b15d375f9af583befddd8c2a2 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<!-- EN-Revision: d7be221e79375970f0973a1ad7f483b0af52846f Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
33

44
<refentry xml:id="mongodb-driver-bulkwrite.update" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -97,6 +97,25 @@
9797
</entry>
9898
<entry>&false;</entry>
9999
</row>
100+
<row>
101+
<entry>sort</entry>
102+
<entry><type class="union"><type>array</type><type>object</type></type></entry>
103+
<entry>
104+
<para>
105+
Especifica que documento a operação atualiza se a consulta corresponder
106+
a múltiplos documentos. O primeiro documento correspondente à ordenação
107+
será atualizado.
108+
</para>
109+
<para>
110+
Esta opção não pode ser usada se <literal>"multi"</literal> for &true;.
111+
</para>
112+
<para>
113+
Esta opção está disponível no MongoDB 8.0+ e resultará em uma
114+
exceção no momento da execução se especificada para uma versão
115+
antiga do servidor.
116+
</para>
117+
</entry>
118+
</row>
100119
<row>
101120
<entry>upsert</entry>
102121
<entry><type>bool</type></entry>
@@ -145,6 +164,12 @@
145164
</row>
146165
</thead>
147166
<tbody>
167+
<row>
168+
<entry>PECL mongodb 1.21.0</entry>
169+
<entry>
170+
Adicionada a opção <literal>"sort"</literal>.
171+
</entry>
172+
</row>
148173
<row>
149174
<entry>PECL mongodb 1.7.0</entry>
150175
<entry>

‎reference/mongodb/mongodb/driver/clientencryption/createdatakey.xml

+7-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 2e94692706b2c5e2515eeeb7ce541c1e289f66ca Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<!-- EN-Revision: 592e10fe7c16ddd3dc1c99f16f7bb1823e9f5b68 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
33

44
<refentry xml:id="mongodb-driver-clientencryption.createdatakey" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -121,6 +121,12 @@
121121
</row>
122122
</thead>
123123
<tbody>
124+
<row>
125+
<entry>PECL mongodb 1.20.0</entry>
126+
<entry>
127+
Adicionada a opção <literal>"delegated"</literal> à opções masterKey do provedor KMIP.
128+
</entry>
129+
</row>
124130
<row>
125131
<entry>PECL mongodb 1.15.0</entry>
126132
<entry>

‎reference/mongodb/mongodb/driver/clientencryption/rewrapmanydatakey.xml

+25-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 9e9578a5c4288bf10c1675da131c79c4e28252a8 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<!-- EN-Revision: 592e10fe7c16ddd3dc1c99f16f7bb1823e9f5b68 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
33

44
<refentry xml:id="mongodb-driver-clientencryption.rewrapmanydatakey" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -102,6 +102,30 @@
102102
<member>Lança <classname>MongoDB\Driver\Exception\RuntimeException</classname> em outros erros.</member>
103103
</simplelist>
104104
</refsect1>
105+
106+
<refsect1 role="changelog">
107+
&reftitle.changelog;
108+
<para>
109+
<informaltable>
110+
<tgroup cols="2">
111+
<thead>
112+
<row>
113+
<entry>&Version;</entry>
114+
<entry>&Description;</entry>
115+
</row>
116+
</thead>
117+
<tbody>
118+
<row>
119+
<entry>PECL mongodb 1.20.0</entry>
120+
<entry>
121+
Adicionada a opção <literal>"delegated"</literal> às opções masterKey do provedor KMIP.
122+
</entry>
123+
</row>
124+
</tbody>
125+
</tgroup>
126+
</informaltable>
127+
</para>
128+
</refsect1>
105129
</refentry>
106130

107131
<!-- Keep this comment at the end of the file

‎reference/mongodb/mongodb/driver/manager/executebulkwrite.xml

+9-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 80693438668530525ea2a78defbfc9bb218c3b1c Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<!-- EN-Revision: 51ea49d0a56569458483a36478f6e5571a59bdc8 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
33

44
<refentry xml:id="mongodb-driver-manager.executebulkwrite" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -13,7 +13,7 @@
1313
<modifier>final</modifier> <modifier>public</modifier> <type>MongoDB\Driver\WriteResult</type><methodname>MongoDB\Driver\Manager::executeBulkWrite</methodname>
1414
<methodparam><type>string</type><parameter>namespace</parameter></methodparam>
1515
<methodparam><type>MongoDB\Driver\BulkWrite</type><parameter>bulk</parameter></methodparam>
16-
<methodparam choice="opt"><type class="union"><type>array</type><type>MongoDB\Driver\WriteConcern</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
16+
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
1717
</methodsynopsis>
1818
<para>
1919
Executa uma ou mais operações de escrita no servidor primário.
@@ -92,6 +92,13 @@
9292
</row>
9393
</thead>
9494
<tbody>
95+
<row>
96+
<entry>PECL mongodb 1.21.0</entry>
97+
<entry>
98+
Passar um objeto <classname>MongoDB\Driver\WriteConcern</classname> como
99+
<parameter>options</parameter> foi descontinuado e será removido na versão 2.0.
100+
</entry>
101+
</row>
95102
<row>
96103
<entry>PECL mongodb 1.4.4</entry>
97104
<entry>

‎reference/mongodb/mongodb/driver/manager/executecommand.xml

+9-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 80693438668530525ea2a78defbfc9bb218c3b1c Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<!-- EN-Revision: 51ea49d0a56569458483a36478f6e5571a59bdc8 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
33

44
<refentry xml:id="mongodb-driver-manager.executecommand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -13,7 +13,7 @@
1313
<modifier>final</modifier> <modifier>public</modifier> <type>MongoDB\Driver\Cursor</type><methodname>MongoDB\Driver\Manager::executeCommand</methodname>
1414
<methodparam><type>string</type><parameter>db</parameter></methodparam>
1515
<methodparam><type>MongoDB\Driver\Command</type><parameter>command</parameter></methodparam>
16-
<methodparam choice="opt"><type class="union"><type>array</type><type>MongoDB\Driver\ReadPreference</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
16+
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
1717
</methodsynopsis>
1818
<para>
1919
Seleciona um servidor de acordo com a opção <literal>"readPreference"</literal>
@@ -96,6 +96,13 @@
9696
</row>
9797
</thead>
9898
<tbody>
99+
<row>
100+
<entry>PECL mongodb 1.21.0</entry>
101+
<entry>
102+
Passar um objeto <classname>MongoDB\Driver\ReadPreference</classname> como
103+
<parameter>options</parameter> foi descontinuado e será removido na versão 2.0.
104+
</entry>
105+
</row>
99106
<row>
100107
<entry>PECL mongodb 1.4.4</entry>
101108
<entry>

‎reference/mongodb/mongodb/driver/manager/executequery.xml

+9-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 80693438668530525ea2a78defbfc9bb218c3b1c Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<!-- EN-Revision: 51ea49d0a56569458483a36478f6e5571a59bdc8 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
33

44
<refentry xml:id="mongodb-driver-manager.executequery" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -13,7 +13,7 @@
1313
<modifier>final</modifier> <modifier>public</modifier> <type>MongoDB\Driver\Cursor</type><methodname>MongoDB\Driver\Manager::executeQuery</methodname>
1414
<methodparam><type>string</type><parameter>namespace</parameter></methodparam>
1515
<methodparam><type>MongoDB\Driver\Query</type><parameter>query</parameter></methodparam>
16-
<methodparam choice="opt"><type class="union"><type>array</type><type>MongoDB\Driver\ReadPreference</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
16+
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
1717
</methodsynopsis>
1818
<para>
1919
Seleciona um servidor de acordo com a opção <literal>"readPreference"</literal>
@@ -83,6 +83,13 @@
8383
</row>
8484
</thead>
8585
<tbody>
86+
<row>
87+
<entry>PECL mongodb 1.21.0</entry>
88+
<entry>
89+
Passar um objeto <classname>MongoDB\Driver\ReadPreference</classname> como
90+
<parameter>options</parameter> foi descontinuado e será removido na versão 2.0.
91+
</entry>
92+
</row>
8693
<row>
8794
<entry>PECL mongodb 1.4.0</entry>
8895
<entry>

‎reference/mongodb/mongodb/driver/server/executebulkwrite.xml

+9-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 80693438668530525ea2a78defbfc9bb218c3b1c Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
2+
<!-- EN-Revision: 51ea49d0a56569458483a36478f6e5571a59bdc8 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
33

44
<refentry xml:id="mongodb-driver-server.executebulkwrite" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -13,7 +13,7 @@
1313
<modifier>final</modifier> <modifier>public</modifier> <type>MongoDB\Driver\WriteResult</type><methodname>MongoDB\Driver\Server::executeBulkWrite</methodname>
1414
<methodparam><type>string</type><parameter>namespace</parameter></methodparam>
1515
<methodparam><type>MongoDB\Driver\BulkWrite</type><parameter>bulk</parameter></methodparam>
16-
<methodparam choice="opt"><type class="union"><type>array</type><type>MongoDB\Driver\WriteConcern</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
16+
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
1717
</methodsynopsis>
1818
<para>
1919
Executa uma ou mais operações de gravação neste servidor.
@@ -92,6 +92,13 @@
9292
</row>
9393
</thead>
9494
<tbody>
95+
<row>
96+
<entry>PECL mongodb 1.21.0</entry>
97+
<entry>
98+
Passar um objeto <classname>MongoDB\Driver\WriteConcern</classname> como
99+
<parameter>options</parameter> foi descontinuado e será removido na versão 2.0.
100+
</entry>
101+
</row>
95102
<row>
96103
<entry>PECL mongodb 1.4.4</entry>
97104
<entry>

0 commit comments

Comments
 (0)