skip()

语法

query.skip( <num> )

类别

SdbQuery

描述

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

参数

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

Note:

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

返回值

返回结果集的游标。

错误

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

常见错误可参考错误码。

示例

  • 选择集合 bar 下的记录，从第2条记录开始返回。
  1. > db.foo.bar.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. }
  • 选择集合 bar 下的记录，从第 4 条记录开始返回。（当前集合只有 3 条记录）
  1. > db.foo.bar.find().skip(3)
  2. Return 0 row(s).