Menu Docs
Página inicial do Docs
/
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 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.

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.

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.

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

Executar:

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

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

var sensorCursor = db.sensor.find()
3

Executar:

sensorCursor.count()

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

4

Executar:

sensorCursor.next()

Saída:

{ _id: 0, temperature: 12 }
5

Executar:

sensorCursor.isExhausted()

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

6

Executar:

sensorCursor.next()

Saída:

{ _id: 1, temperature: 23 }
7

Executar:

sensorCursor.next()

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

8

Executar:

sensorCursor.isExhausted()

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

Voltar

cursor.hint