对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单
Docs 主页
/
开发中
/
mongosh 方法
Docs 主页
/
开发中
/
mongosh 方法
Docs 主页
/
开发中
/
mongosh 方法

游标()（mongosh方法）

cursor.isExhausted()

重要

mongosh 方法

本页介绍了 mongosh 方法。这不是特定于语言的驾驶员（例如 Node.js）的文档。

对于MongoDB API驱动程序，请参阅特定语言的MongoDB驾驶员文档。

返回：

布尔

如果文档仍在游标读取的当前文档批处理中，则 cursor.isExhausted() 返回 false。否则，返回 true。

兼容性

此方法可用于以下环境中托管的部署：

  • MongoDB Atlas ：用于在云中部署MongoDB 的完全托管服务

注意

所有MongoDB Atlas集群都支持此命令。有关Atlas支持所有命令的信息，请参阅不支持的命令。

行为

可追加游标

您可以将isExhausted()与可追加游标一起使用。即使当前批处理中没有剩余文档，可追加游标也会保持打开状态。当没有剩余文档时，其他游标会自动关闭。

Change Streams

您不能将isExhausted()与change stream一起使用。相反，要检查是否：

有关change stream示例，请参阅监视示例和change stream图像示例。

示例

This section contains examples that use a cursor to read documents from a collection with temperature readings from a weather sensor. 您将看到isExhausted()的示例。

1

创建集合

运行：

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

创建游标变量

创建一个名为sensorCursor的游标变量，用于读取sensor集合中的文档：

var sensorCursor = db.sensor.find()
3

计算游标中的文档数量

运行：

sensorCursor.count()

输出为2 ，因为collection中有两个文档。

4

返回游标中的第一个文档

运行：

sensorCursor.next()

输出：

{ _id: 0, temperature: 12 }
5

isExhausted()检查 值

运行：

sensorCursor.isExhausted()

输出为false ，因为sensorCursor中有剩余文档。

6

返回游标处的下一个文档

运行：

sensorCursor.next()

输出：

{ _id: 1, temperature: 23 }
7

尝试从游标返回下一个文档

运行：

sensorCursor.next()

没有更多文档，该示例返回null 。

8

isExhausted()检查 值

运行：

sensorCursor.isExhausted()

没有更多文档， isExhausted()返回true 。

后退
cursor.hint
来年
游标.itcount
给本页内容打分

在此页面上