Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

cursor.isExhausted()

Nesta página

  • Compatibilidade
  • Comportamento
  • Exemplos
cursor.isExhausted()

Importante

Método mongosh

Este é um método mongosh . Esta não é a documentação de Node.js ou de outros métodos de driver específicos da linguagem de programação.

Na maioria dos casos, os métodos mongosh funcionam da mesma forma que os métodos legado do shell mongo . No entanto, alguns métodos legado não estão disponíveis em mongosh.

Para a documentação do shell legado mongo, consulte a documentação para a release correspondente do MongoDB Server:

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

Retorna:Boolean

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

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

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.

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

Para ver um exemplo de change stream, consulte Exemplo de observação.

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