Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Métodos de mongosh
/
Cursors

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 de um driver de idioma específico, como Node.js.

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

Retorna:Boolean

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

Comportamento

Cursores persistentes

Você pode usar isExhausted() com umcursor 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 isExhausted() valor

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 isExhausted() valor

Executar:

sensorCursor.isExhausted()

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

Voltar

cursor.hint

Próximo

cursor.itcount