Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

cursor.isExhausted()

Nesta página

  • Comportamento
  • Exemplos
cursor.isExhausted()

Importante

Método mongosh

Esta página documenta um método mongosh . Esta não é a documentação para um driver específico de idioma, como Node.js.

Para drivers de API do MongoDB, consulte a documentação do driver MongoDB específica do idioma.

Retorna:Boolean

cursor.isExhausted() retorna false se os documentos permanecerem no lote de documentos atual lido pelo cursor. Caso contrário, retorna true.

Comportamento

Cursores rastreáveis

Você pode usar isExhausted() com um cursor persistente. Um cursor persistente permanece aberto mesmo que nenhum documento permaneça no lote atual. Outros cursores são fechados automaticamente quando nenhum documento permanece.

Fluxos de alterações

Você não pode usar o isExhausted() com fluxos de alteração . Em vez disso, para examinar se:

  • documento permanecem em um cursor de change stream, use cursor.tryNext().

  • um cursor de fluxo de alterações estiver fechado, use cursor.isClosed() .

Para exemplos de change stream, consulte Exemplo de Assista e Exemplo de Imagens de change stream.

Exemplos

Esta seção contém exemplos que usam um cursor para ler documento de uma collection com leituras de temperatura de um sensor meteorológico. Você verá exemplos de isExhausted().

1

Criar a coleção

Executar:

db.sensor.insertMany( [
   { _id: 0, temperature: 12 },
   { _id: 1, temperature: 23 }
] )
2

Criar uma variável do cursor

Crie um cursor chamado sensorCursor que leia os documento da collection sensor :

var sensorCursor = db.sensor.find()
3

Conte o número de documentos no cursor

Executar:

sensorCursor.count()

A saída é 2 porque há dois documento na collection.

4

Retornar o primeiro documento do cursor

Executar:

sensorCursor.next()

Saída:

{ _id: 0, temperature: 12 }
5

Examine o valor isExhausted()

Executar:

sensorCursor.isExhausted()

A saída é false porque há um documento restante em sensorCursor .

6

Retornar o próximo documento do cursor

Executar:

sensorCursor.next()

Saída:

{ _id: 1, temperature: 23 }
7

Tentar retornar o próximo documento do cursor

Executar:

sensorCursor.next()

Não há mais documentos e o exemplo retorna null.

8

Examine o valor isExhausted()

Executar:

sensorCursor.isExhausted()

Não há mais documentos e isExhausted() retorna true.

← cursor.hint()
cursor.itcount() →

Nesta página