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

cursor.isExhausted()

Nesta página

  • Compatibilidade
  • 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.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Observação

Este comando é aceito em todos os clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

  • MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

  • MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Comportamento

Cursores persistentes

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:

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