diff --git a/reference/mongodb/mongodb/driver/cursor.xml b/reference/mongodb/mongodb/driver/cursor.xml index bbbe7a340..45d1f4bb0 100644 --- a/reference/mongodb/mongodb/driver/cursor.xml +++ b/reference/mongodb/mongodb/driver/cursor.xml @@ -1,5 +1,5 @@ - + @@ -11,12 +11,12 @@
&reftitle.intro; - + A classe MongoDB\Driver\Cursor encapsula os resultados de um comando ou consulta MongoDB e podem ser retornados por MongoDB\Driver\Manager::executeCommand ou MongoDB\Driver\Manager::executeQuery, respectivamente. - +
@@ -49,33 +49,31 @@
&reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.9.0 - - Implementa Iterator. - - - - PECL mongodb 1.6.0 - - Implementa MongoDB\Driver\CursorInterface, - que estende Traversable. - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.9.0 + + Implementa Iterator. + + + + PECL mongodb 1.6.0 + + Implementa MongoDB\Driver\CursorInterface, + que estende Traversable. + + + + +
@@ -83,19 +81,19 @@ Lendo um conjunto de resultados - + MongoDB\Driver\Manager::executeCommand e MongoDB\Driver\Manager::executeQuery ambos retornam seus resultados como um objeto MongoDB\Driver\Cursor. Este objeto pode ser usado para iterar sobre conjunto de resultados do comando ou consulta. - - + + Como MongoDB\Driver\Cursor implementa a interface Traversable, pode-se simplesmente iterar pelo conjunto de resultados com foreach. - + Lendo um conjunto de resultados com um cursor adaptável - + Cursores adaptáveis são um tipo especial de cursor no MongoDB que permite ao cliente ler alguns resultados e então esperar até que mais documentos fiquem disponíveis. Esses cursores são usado principalmente com Coleções Limitadas e Fluxos de Alterações. - - + + Enquanto os cursores normais podem ser iterados com foreach, esse método não irá funcionar com cursores adaptáveis. Quando foreach é usado com um cursor adaptável, a repetição irá @@ -172,21 +170,21 @@ stdClass Object retroceder o cursor. De forma similar aos objetos de resultados em outros drivers de bancos de dados, os cursores no MongoDB suportam apenas iteração para a frente, ou seja, eles não podem ser retrocedidos. - - + + Para ler continuamente a partir de um cursor adaptável, o objeto Cursor deve ser encapsulado com um IteratorIterator. Isso permite que a aplicação controle diretamente a iteração do cursor, evite retroceder inadvertidamente o cursor e decida quando esperar por novos resultados ou interromper totalmente a iteração. - - + + Para demonstrar um cursor adaptável em ação, serão utilizados dois scripts: um "produtor" e um "consumidor". O script produtor criará uma nova coleção limitada usando o comando create e procederá à inserção de um novo documento nessa coleção a cada segundo. - + ]]> - + Com o script produtor ainda em execução, um segundo script consumidor pode ser executado para ler os documentos inseridos usando um cursor adaptável, indicado pelas opções tailable e awaitData para o método MongoDB\Driver\Query::__construct. - + ]]> - + O script consumidor começará mostrando rapidamente todos os documentos disponíveis na coleção limitada (como se foreach tivesse sido usado); entretanto, ele não terminará ao atingir o final do conjunto de resultados inicial. @@ -253,7 +251,7 @@ while (true) { IteratorIterator::next bloqueará e aguardará resultados adicionais. IteratorIterator::valid também é usado para verificar se realmente há dados disponíveis para leitura em cada etapa. - + Este exemplo usa a opção de consulta awaitData para diff --git a/reference/mongodb/mongodb/driver/cursor/construct.xml b/reference/mongodb/mongodb/driver/cursor/construct.xml index 4140cb594..8dc1d321d 100644 --- a/reference/mongodb/mongodb/driver/cursor/construct.xml +++ b/reference/mongodb/mongodb/driver/cursor/construct.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ final private MongoDB\Driver\Cursor::__construct - + Objetos MongoDB\Driver\Cursor são retornados como o o resultado de consultas ou comandos executados e não podem ser construídos diretamente. - + diff --git a/reference/mongodb/mongodb/driver/cursor/current.xml b/reference/mongodb/mongodb/driver/cursor/current.xml index cd777802f..9cbf5da96 100644 --- a/reference/mongodb/mongodb/driver/cursor/current.xml +++ b/reference/mongodb/mongodb/driver/cursor/current.xml @@ -1,6 +1,6 @@ - + MongoDB\Driver\Cursor::current @@ -22,11 +22,11 @@ &reftitle.returnvalues; - + Retorna o documento de resultado atual como um array ou objeto, dependendo do mapa de tipo do cursor. Se a iteração não tiver iniciado ou se a posição atual não for válida, retorna &null;. - + diff --git a/reference/mongodb/mongodb/driver/cursor/getid.xml b/reference/mongodb/mongodb/driver/cursor/getid.xml index 4c3bc0d34..29af18d00 100644 --- a/reference/mongodb/mongodb/driver/cursor/getid.xml +++ b/reference/mongodb/mongodb/driver/cursor/getid.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ final public MongoDB\BSON\Int64MongoDB\Driver\Cursor::getId - + Retorna o ID para este cursor, que identifica de forma única o cursor no servidor. - + @@ -26,10 +26,10 @@ &reftitle.returnvalues; - + Retorna o ID para este cursor. O ID será retornado como um objeto MongoDB\BSON\Int64. - + @@ -41,36 +41,34 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 2.0.0 - - O tipo de retorno foi alterado para MongoDB\BSON\Int64. - O parâmetro asInt64 foi removido. - - - - PECL mongodb 1.20.0 - - O retorno de um MongoDB\Driver\CursorId foi descontinuado. - Adicionado o parâmetro asInt64 para facilitar a migração para - versões futuras. Se asInt64 for &true;, o ID - será retornado como um MongoDB\BSON\Int64. - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 2.0.0 + + O tipo de retorno foi alterado para MongoDB\BSON\Int64. + O parâmetro asInt64 foi removido. + + + + PECL mongodb 1.20.0 + + O retorno de um MongoDB\Driver\CursorId foi descontinuado. + Adicionado o parâmetro asInt64 para facilitar a migração para + versões futuras. Se asInt64 for &true;, o ID + será retornado como um MongoDB\BSON\Int64. + + + + + diff --git a/reference/mongodb/mongodb/driver/cursor/getserver.xml b/reference/mongodb/mongodb/driver/cursor/getserver.xml index 1674dd839..4bb900169 100644 --- a/reference/mongodb/mongodb/driver/cursor/getserver.xml +++ b/reference/mongodb/mongodb/driver/cursor/getserver.xml @@ -1,5 +1,5 @@ - + @@ -13,12 +13,12 @@ final public MongoDB\Driver\ServerMongoDB\Driver\Cursor::getServer - + Retorna o MongoDB\Driver\Server associado a este cursor. Este é o servidor que executou a MongoDB\Driver\Query ou o MongoDB\Driver\Command. - + @@ -28,10 +28,10 @@ &reftitle.returnvalues; - + Retorna o MongoDB\Driver\Server associado a este cursor. - + diff --git a/reference/mongodb/mongodb/driver/cursor/isdead.xml b/reference/mongodb/mongodb/driver/cursor/isdead.xml index 5134ae8c6..aff49a449 100644 --- a/reference/mongodb/mongodb/driver/cursor/isdead.xml +++ b/reference/mongodb/mongodb/driver/cursor/isdead.xml @@ -1,5 +1,5 @@ - + @@ -13,13 +13,13 @@ final public boolMongoDB\Driver\Cursor::isDead - + Verifica se definitivamente não há resultados adicionais disponíveis no cursor. Este método é semelhante ao método cursor.isExhausted() no shell do MongoDB e é útil principalmente ao iterar cursores adaptáveis. - + Um cursor não tem resultados adicionais e é considerado "morto" quando uma das seguintes opções for verdadeira: @@ -62,10 +62,10 @@ &reftitle.returnvalues; - + Retorna &true; se definitivamente não houver resultados adicionais disponíveis no cursor e &false; caso contrário. - + diff --git a/reference/mongodb/mongodb/driver/cursor/key.xml b/reference/mongodb/mongodb/driver/cursor/key.xml index 2658be21e..fe7453943 100644 --- a/reference/mongodb/mongodb/driver/cursor/key.xml +++ b/reference/mongodb/mongodb/driver/cursor/key.xml @@ -1,6 +1,6 @@ - + MongoDB\Driver\Cursor::key @@ -22,9 +22,9 @@ &reftitle.returnvalues; - + O índice numérico do resultado atual dentro do cursor. - + diff --git a/reference/mongodb/mongodb/driver/cursor/next.xml b/reference/mongodb/mongodb/driver/cursor/next.xml index 8042c16c5..d8dabb62d 100644 --- a/reference/mongodb/mongodb/driver/cursor/next.xml +++ b/reference/mongodb/mongodb/driver/cursor/next.xml @@ -1,6 +1,6 @@ - + MongoDB\Driver\Cursor::next @@ -22,9 +22,9 @@ &reftitle.returnvalues; - + Move a posição atual para o próximo elemento no cursor. - + diff --git a/reference/mongodb/mongodb/driver/cursor/rewind.xml b/reference/mongodb/mongodb/driver/cursor/rewind.xml index ca65eda6f..ba4280030 100644 --- a/reference/mongodb/mongodb/driver/cursor/rewind.xml +++ b/reference/mongodb/mongodb/driver/cursor/rewind.xml @@ -1,6 +1,6 @@ - + MongoDB\Driver\Cursor::rewind @@ -13,10 +13,10 @@ public voidMongoDB\Driver\Cursor::rewind - + Se o cursor tiver avançado além da sua primeira posição, não poderá mais ser retrocedido. - + @@ -26,9 +26,9 @@ &reftitle.returnvalues; - + &null;. - + diff --git a/reference/mongodb/mongodb/driver/cursor/settypemap.xml b/reference/mongodb/mongodb/driver/cursor/settypemap.xml index db29eb363..34b3117ef 100644 --- a/reference/mongodb/mongodb/driver/cursor/settypemap.xml +++ b/reference/mongodb/mongodb/driver/cursor/settypemap.xml @@ -1,5 +1,5 @@ - + @@ -13,11 +13,11 @@ final public voidMongoDB\Driver\Cursor::setTypeMap arraytypemap - + Define a configuração do mapa de tipos a ser usada ao desserializar os resultados do BSON em valores PHP. - + @@ -29,9 +29,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/mongodb/mongodb/driver/cursor/toarray.xml b/reference/mongodb/mongodb/driver/cursor/toarray.xml index 634c3436c..8e640eb5c 100644 --- a/reference/mongodb/mongodb/driver/cursor/toarray.xml +++ b/reference/mongodb/mongodb/driver/cursor/toarray.xml @@ -1,5 +1,5 @@ - + @@ -13,11 +13,11 @@ final public arrayMongoDB\Driver\Cursor::toArray - + Itera o cursor e retorna seus resultados em um aray. A função MongoDB\Driver\Cursor::setTypeMap pode ser usada para controlar como os documentos são desserializados em valores PHP. - + @@ -27,9 +27,9 @@ &reftitle.returnvalues; - + Retorna um array contendo todos os resultados deste cursor. - + diff --git a/reference/mongodb/mongodb/driver/cursor/valid.xml b/reference/mongodb/mongodb/driver/cursor/valid.xml index 1e33cddd7..742c27972 100644 --- a/reference/mongodb/mongodb/driver/cursor/valid.xml +++ b/reference/mongodb/mongodb/driver/cursor/valid.xml @@ -1,6 +1,6 @@ - + MongoDB\Driver\Cursor::valid @@ -22,9 +22,9 @@ &reftitle.returnvalues; - + &true; se a posição atual do cursor for válida, &false; caso contrário. - + diff --git a/reference/mongodb/mongodb/driver/cursorid.xml b/reference/mongodb/mongodb/driver/cursorid.xml index 0ed5afe51..353df67f4 100644 --- a/reference/mongodb/mongodb/driver/cursorid.xml +++ b/reference/mongodb/mongodb/driver/cursorid.xml @@ -1,5 +1,5 @@ - + @@ -11,18 +11,18 @@
&reftitle.intro; - + A classe MongoDB\Driver\CursorID é um objeto de valor que representa um ID de cursor. Instâncias desta classe são retornadas por MongoDB\Driver\Cursor::getId. - + - + Esta classe foi DESCONTINUADA a partir da versão de extensão 1.20.0 e foi removida na versão 2.0. As aplicações devem atualizar seu uso de MongoDB\Driver\Cursor::getId para retornar um MongoDB\BSON\Int64 no lugar. - +
@@ -60,39 +60,37 @@
&reftitle.changelog; - - - - - - &Version; - &Description; - - - - &mongodb.changelog.class-removed; - - PECL mongodb 1.20.0 - - Esta classe foi descontinuada e será removida na versão 2.0. - - - - PECL mongodb 1.12.0 - - Implementa Stringable para o PHP 8.0+. - - - - PECL mongodb 1.7.0 - - Implementa Serializable. - - - - - - + + + + + &Version; + &Description; + + + + &mongodb.changelog.class-removed; + + PECL mongodb 1.20.0 + + Esta classe foi descontinuada e será removida na versão 2.0. + + + + PECL mongodb 1.12.0 + + Implementa Stringable para o PHP 8.0+. + + + + PECL mongodb 1.7.0 + + Implementa Serializable. + + + + +
diff --git a/reference/mongodb/mongodb/driver/cursorid/construct.xml b/reference/mongodb/mongodb/driver/cursorid/construct.xml index f26cea81c..7f4b0f999 100644 --- a/reference/mongodb/mongodb/driver/cursorid/construct.xml +++ b/reference/mongodb/mongodb/driver/cursorid/construct.xml @@ -1,5 +1,5 @@ - + @@ -13,11 +13,11 @@ final private MongoDB\Driver\CursorId::__construct - + Objetos MongoDB\Driver\CursorId são retornados pela função MongoDB\Driver\Cursor::getId e não podem ser construídos diretamente. - + diff --git a/reference/mongodb/mongodb/driver/cursorid/tostring.xml b/reference/mongodb/mongodb/driver/cursorid/tostring.xml index 44f305219..2592f0149 100644 --- a/reference/mongodb/mongodb/driver/cursorid/tostring.xml +++ b/reference/mongodb/mongodb/driver/cursorid/tostring.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ final public stringMongoDB\Driver\CursorId::__toString - + Retorna a representação em string do ID de cursor. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + Retorna a representação em string do ID de cursor. - + diff --git a/reference/mongodb/mongodb/driver/cursorinterface.xml b/reference/mongodb/mongodb/driver/cursorinterface.xml index f0e469bcd..74bbcbb2c 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface.xml @@ -1,5 +1,5 @@ - + @@ -11,11 +11,11 @@
&reftitle.intro; - + Esta interface é implementada por MongoDB\Driver\Cursor para ser usada como um tipo de parâmetro, de retorno ou de propriedade em classes do usuário. - +
@@ -47,32 +47,30 @@
&reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 2.0.0 - - - Esta interface agora estende Iterator. - - - Tipos de retorno anteriormente declarados como temporários agora devem ser cumpridos. - - - - &mongodb.changelog.tentative-return-types; - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 2.0.0 + + + Esta interface agora estende Iterator. + + + Tipos de retorno anteriormente declarados como temporários agora devem ser cumpridos. + + + + &mongodb.changelog.tentative-return-types; + + +
diff --git a/reference/mongodb/mongodb/driver/cursorinterface/getid.xml b/reference/mongodb/mongodb/driver/cursorinterface/getid.xml index 545ebefea..a111138d2 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface/getid.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface/getid.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ abstract public MongoDB\BSON\Int64MongoDB\Driver\CursorInterface::getId - + Retorna o ID deste cursor, que identifica o cursor de forma única no servidor. - + @@ -26,9 +26,9 @@ &reftitle.returnvalues; - + Retorna o ID deste cursor. - + @@ -40,28 +40,26 @@ &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - PECL mongodb 1.20.0 - - Adicionado MongoDB\BSON\Int64 ao tipo de retorno - provisório para este método. MongoDB\Driver\CursorId - será removido do tipo de retorno na versão 2.0. - - - - - - + + + + + &Version; + &Description; + + + + + PECL mongodb 1.20.0 + + Adicionado MongoDB\BSON\Int64 ao tipo de retorno + provisório para este método. MongoDB\Driver\CursorId + será removido do tipo de retorno na versão 2.0. + + + + + diff --git a/reference/mongodb/mongodb/driver/cursorinterface/getserver.xml b/reference/mongodb/mongodb/driver/cursorinterface/getserver.xml index eefeeeb57..b836c0f31 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface/getserver.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface/getserver.xml @@ -1,5 +1,5 @@ - + @@ -13,12 +13,12 @@ abstract public MongoDB\Driver\ServerMongoDB\Driver\CursorInterface::getServer - + Retorna o MongoDB\Driver\Server associado a este cursor. Este é o servidor que executou a MongoDB\Driver\Query ou o MongoDB\Driver\Command. - + @@ -28,10 +28,10 @@ &reftitle.returnvalues; - + Retorna o MongoDB\Driver\Server associado a este cursor. - + diff --git a/reference/mongodb/mongodb/driver/cursorinterface/isdead.xml b/reference/mongodb/mongodb/driver/cursorinterface/isdead.xml index b7f655fbc..8c5cf0248 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface/isdead.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface/isdead.xml @@ -1,5 +1,5 @@ - + @@ -34,10 +34,10 @@ &reftitle.returnvalues; - + Retorna &true; se não houver resultados adicionais disponíveis ou &false; caso contrário. - + diff --git a/reference/mongodb/mongodb/driver/cursorinterface/settypemap.xml b/reference/mongodb/mongodb/driver/cursorinterface/settypemap.xml index d79d71da8..3e9625436 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface/settypemap.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface/settypemap.xml @@ -1,5 +1,5 @@ - + @@ -13,11 +13,11 @@ abstract public voidMongoDB\Driver\CursorInterface::setTypeMap arraytypemap - + Define a configuração do mapa de tipos a ser usada ao desserializar os resultados do BSON em valores PHP. - + @@ -29,9 +29,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/mongodb/mongodb/driver/cursorinterface/toarray.xml b/reference/mongodb/mongodb/driver/cursorinterface/toarray.xml index f7222180f..0186b2350 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface/toarray.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface/toarray.xml @@ -1,5 +1,5 @@ - + @@ -13,11 +13,11 @@ abstract public arrayMongoDB\Driver\CursorInterface::toArray - + Itera o cursor e retorna seus resultados em um array. A função MongoDB\Driver\CursorInterface::setTypeMap pode ser usada para controlar como os documentos serão desserializados em valores PHP. - + @@ -27,9 +27,9 @@ &reftitle.returnvalues; - + Retorna um array contendo todos os resultados deste cursor. - +