close()

名称

close - 关闭当前游标

语法

cursor.close()

类别

SdbCursor

描述

该函数用于关闭当前游标，关闭后游标将无法获取记录。

参数

无

返回值

函数执行成功时，无返回值。

函数执行失败时，将抛异常并输出错误信息。

错误

当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。

版本

v3.0 及以上版本

示例

1. 插入 10 条记录

   > for(i = 0; i < 10; i++) {db.sample.employee.insert({a: i})}

2. 查询集合 sample.employee 的所有记录

   > var cur = db.sample.employee.find()

3. 使用游标取出一条记录

   > cur.next()
   {
        "_id": {
        "$oid": "53b3c2d7bb65d2f74c000000"
        },
        "a": 0
   }

4. 关闭游标

   > cur.close()

5. 再次获取下一条记录，无结果返回

   > cur.next()