count()

名称

count - 统计当前集合符合条件的记录总数

语法

db.collectionspace.collection.count([cond])

db.collectionspace.collection.count([cond]).hint([hint])

类别

SdbCollection

描述

该函数用于统计当前集合符合条件的记录总数，可通过 hint 指定查询使用的索引。

参数

参数 cond 和 hint 的用法与 find() 的相同。

返回值

函数执行成功时，将返回一个 CLCount 类型的对象。通过该对象获取符合条件的记录总数。

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

错误

count()函数常见异常如下：

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

版本

v1.0 及以上版本

示例

• 统计集合 sample.employee 所有的记录数，即不指定参数 cond

  db.sample.employee.count()

• 统计符合条件 name 字段的值为"Tom"且 age 字段的值大于 25 的记录数

  > db.sample.employee.count({name: "Tom", age: {$gt: 25}})

• 统计符合条件 name 字段的值为"Tom"且 age 字段的值大于 25 的记录数，使用索引 nameIdx

  > db.sample.employee.count({name: "Tom", age: {$gt: 25}}).hint({"": "nameIdx"})