limit()

语法

query.limit( <num> )

类别

SdbQuery

描述

控制查询返回的记录条数。

参数

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

Note:

query.limit() 方法的定义格式包含 num 参数,它是 int 类型。如果不设定 num 的内容,相当于返回所有的结果集记录。如果结果集的记录数小于 num,按实际的记录数返回,如果结果集的记录数大于 num,则只返回前 num 条记录。

返回值

返回结果集的游标。

错误

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

常见错误可参考错误码

示例

  • 选择集合 bar 下 age 字段值大于10的记录(如使用 $gt 查询),并只返回前面2条记录。
  1. > db.foo.bar.find( { age: { $gt: 10 } } ).limit( 2 )
  2. {
  3. "_id": {
  4. "$oid": "5813035cc842af52b6000009"
  5. },
  6. "name": "Tom",
  7. "age": 11
  8. }
  9. {
  10. "_id": {
  11. "$oid": "58130372c842af52b600000a"
  12. },
  13. "name": "Jack",
  14. "age": 12
  15. }