/ /

Cursors

Docs Home

/ /

cursor.isExhausted()

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 5.0, consulta el Procedimientos de actualización de MongoDB 6.0 .

cursor.isExhausted()

Importante

Método mongosh

Este es un método mongosh. Esta no es la documentación de Node.js ni de otros métodos de controladores específicos de lenguajes de programación.

En la mayoría de los casos, los métodos mongosh funcionan de la misma manera que los métodos tradicionales mongo métodos shell. Sin embargo, algunos métodos heredados no están disponibles en mongosh.

Para la documentación heredada de mongo shell, revisa la documentación de la versión correspondiente de MongoDB Server:

Para los controladores de la API de MongoDB, consultar la documentación específica del controlador de MongoDB para cada lenguaje.

Devuelve:	Booleano

cursor.isExhausted() devuelve false si quedan documentos en la actual agrupación de documentos leídos por el cursor. De lo contrario, devuelve true.

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

Puedes usar isExhausted() con un cursor con seguimiento. Un cursor con seguimiento permanece abierto incluso si no quedan documentos en el lote actual. Otros cursores se cierran automáticamente cuando no quedan documentos.

Flujos de cambio

No puedes usar isExhausted() con corrrientes de cambios. En su lugar, para examinar si:

los documentos permanecen en un cursor de flujo de cambios, use cursor.tryNext().
un cursor de flujo de cambios está cerrado, utiliza cursor.isClosed().

Para un ejemplo de flujo de cambios, consulte Ejemplo de vigilancia.

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().

Crear la colección

Ejecuta:

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

Crear una variable cursor

Crear una variable cursor llamada sensorCursor que lea los documentos de la colección sensor:

var sensorCursor = db.sensor.find()

Cuenta el número de documentos en el cursor

Ejecuta:

sensorCursor.count()

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

Devuelve el primer documento desde el cursor

Ejecuta:

sensorCursor.next()

Salida:

{ _id: 0, temperature: 12 }

Examinar el valor de `isExhausted()`

Ejecuta:

sensorCursor.isExhausted()

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

Devuelve el siguiente documento del cursor

Ejecuta:

sensorCursor.next()

Salida:

{ _id: 1, temperature: 23 }

Intentar devolver el siguiente documento del cursor

Ejecuta:

sensorCursor.next()

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

Examinar el valor de `isExhausted()`

Ejecuta:

sensorCursor.isExhausted()

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

Volver

cursor.hint

cursor.itcount

Importante

Método mongosh

Compatibilidad

Nota

Comportamiento

Cursores con seguimiento

Flujos de cambio

Ejemplos

Crear la colección

Crear una variable cursor

Cuenta el número de documentos en el cursor

Devuelve el primer documento desde el cursor

Examinar el valor de isExhausted()

Devuelve el siguiente documento del cursor

Intentar devolver el siguiente documento del cursor

Examinar el valor de isExhausted()

Examinar el valor de `isExhausted()`

Examinar el valor de `isExhausted()`