Docs 菜单
Docs 主页
/
MongoDB Manual
/
参考
/
mongosh 方法
/
Cursors

cursor.isExhausted()

在此页面上

  • 兼容性
  • 行为
  • 示例
cursor.isExhausted()

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是特定于语言的驱动程序（例如 Node.js）的文档。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

返回：布尔

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

兼容性

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

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

注意

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

  • MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

  • MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

行为

可追加游标

您可以将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

在此页面上