skip()

语法

query.skip( [num] )

类别

SdbQuery

描述

指定结果集从哪条记录开始返回。

参数

参数名参数类型默认值描述是否必填
numint—-自定义结果集从哪条记录返回是

Note:

如果结果集的记录数小于 ( num + 1 )，无记录返回。

返回值

返回结果集的游标。

错误

如果出错则抛异常，并输出错误信息，可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。 关于错误处理可以参考常见错误处理指南。

常见错误可参考错误码。

示例

  • 选择集合 employee 下的记录，从第2条记录开始返回。

    1. > db.sample.employee.find().skip(1)
    2. {
    3.   "_id": {
    4.     "$oid": "5cf8aefe5e72aea111e82b39"
    5.   },
    6.   "name": "ben",
    7.   "age": 21
    8. }
    9. {
    10.   "_id": {
    11.     "$oid": "5cf8af065e72aea111e82b3a"
    12.   },
    13.   "name": "alice",
    14.   "age": 19
    15. }

  • 选择集合 employee 下的记录，从第 4 条记录开始返回。（当前集合只有 3 条记录）

    1. > db.sample.employee.find().skip(3)
    2. Return 0 row(s).