Docs Menu
Docs Home
/ /
Cursors
Docs Home
/ /
Métodos mongosh
/
Cursors
Docs Home
/
Manual de base de datos
/
Referencia
/
Métodos mongosh
/
Cursors

cursor.isExhausted() (método mongosh)

cursor.isExhausted()

Importante

Método mongosh

Esta página documenta un método mongosh. Esta no es la documentación para un driver específico de lenguaje, como Node.js.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Devuelve:Booleano

cursor.isExhausted() devuelve false si los documentos permanecen en el lote actual leído por el cursor. De lo contrario,true devuelve.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

  • MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

  • MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

  • MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Comportamiento

Cursores con seguimiento

Puede usar isExhausted() con un cursor adaptable. Este cursor permanece abierto incluso si no quedan documentos en el lote actual. Los demás cursores se cierran automáticamente cuando no quedan documentos.

Flujos de cambio

No se puede usar isExhausted() con flujos de cambios. En su lugar, para examinar si:

Para ver ejemplos de secuencias de cambios, consulte Ver ejemplo y Ejemplo de imágenes de secuencias de cambios.

Ejemplos

Esta sección contiene ejemplos que utilizan un cursor para leer documentos de una colección con lecturas de temperatura de un sensor meteorológico. Verás ejemplos de isExhausted().

1

Crear la colección

Ejecuta:

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

Crear una variable cursor

Cree una variable de cursor denominada sensorCursor que lea los documentos de la colección sensor:

var sensorCursor = db.sensor.find()
3

Cuente el número de documentos en el cursor

Ejecuta:

sensorCursor.count()

La salida es 2 porque hay dos documentos en la colección.

4

Devolver el primer documento desde el cursor

Ejecuta:

sensorCursor.next()

Salida:

{ _id: 0, temperature: 12 }
5

Examinar el isExhausted() valor

Ejecuta:

sensorCursor.isExhausted()

La salida es false porque hay un documento restante en sensorCursor.

6

Regresar al siguiente documento desde el cursor

Ejecuta:

sensorCursor.next()

Salida:

{ _id: 1, temperature: 23 }
7

Intentar regresar al siguiente documento desde el cursor

Ejecuta:

sensorCursor.next()

No hay más documentos y el ejemplo devuelve null.

8

Examinar el isExhausted() valor

Ejecuta:

sensorCursor.isExhausted()

No hay más documentos y isExhausted() devuelve true.

Volver

cursor.hint

Next

cursor.itcount

En esta página