/ /

计算文档

Overview

在本指南中，您可以学习；了解如何检索集合中文档数量的准确估计计数。

样本数据

The examples in this guide use the movies collection in the sample_mflix database from the Atlas sample datasets. To learn how to create a free MongoDB Atlas cluster and load the sample datasets, see the MongoDB Get Started guide.

检索准确的计数

使用 mongoc_collection_count_documents() 函数计算集合中的文档数量。要计算与指定搜索条件匹配的文档数量，请将查询过滤传递给 mongoc_collection_count_documents() 函数。

要学习；了解有关指定查询的更多信息，请参阅指定查询。

对所有文档进行计数

要返回集合中所有文档的计数，请使用空查询过滤调用 mongoc_collection_count_documents() 函数，如以下示例所示：

bson_error_t error;
bson_t *empty_query = bson_new();
int64_t count = 
    mongoc_collection_count_documents(collection, empty_query, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(empty_query);

对特定文档进行计数

要返回匹配特定搜索条件的文档计数，请在 mongoc_collection_count_documents() 函数中指定您的查询。以下示例将打印 movies集合中 year字段值等于 1930 的所有文档的计数：

bson_error_t error;
bson_t *query = BCON_NEW("year", BCON_INT32(1930));
int64_t count =
    mongoc_collection_count_documents(collection, query, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(query);

自定义计数行为

mongoc_collection_count_documents() 函数接受 bson_t 结构形式的可选参数，该结构表示一设立可用于配置计数操作的选项。如果不指定任何选项，驱动程序不会自定义计数操作。

下表描述了可以设置用于自定义countDocuments()的选项：

选项	说明
`comment`	指定要附加到操作的注释。
`skip`	设置返回结果之前要跳过的文档数。
`limit`	设置要计数的最大文档数。必须为正整数。
`collation`	指定对结果进行排序时要使用的语言排序规则类型。有关更多信息，请参阅 MongoDB Server 手册中的排序规则。
`hint`	设置扫描文档的索引。

有关选项的完整列表，请参阅 API文档的 mongoc_collection_count_documents()。

以下示例使用 bson_t 结构为 mongoc_collection_count_documents() 操作添加注释：

bson_error_t error;
bson_t *opts = BCON_NEW("comment", BCON_UTF8("Retrieving count"));
int64_t count =
    mongoc_collection_count_documents(collection, bson_new(), opts, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(opts);

检索估计计数

使用 mongoc_collection_estimated_document_count() 函数检索集合中文档数量的估计值。该函数根据集合元数据估计文档的数量，这可能比执行精确计数更快。

以下示例打印集合中的估计文档数：

bson_error_t error;
int64_t count =
    mongoc_collection_estimated_document_count(collection, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);

自定义估计计数行为

mongoc_collection_estimated_document_count() 函数接受 bson_t 结构形式的可选参数，该结构表示可用于配置计数操作的选项。如果不指定任何选项，驱动程序不会自定义计数操作。

下表描述了可以设置用于自定义mongoc_collection_estimated_document_count()的选项：

选项	说明
`comment`	指定要附加到操作的注释。
`collation`	指定对结果进行排序时要使用的语言排序规则类型。有关更多信息，请参阅 MongoDB Server 手册中的排序规则。

有关选项的完整列表，请参阅 API文档的 mongoc_collection_estimated_document_count()。

以下示例使用 bson_t 结构为 mongoc_collection_estimated_document_count() 操作添加注释：

bson_error_t error;
bson_t *opts = BCON_NEW("comment", BCON_UTF8("Retrieving count"));
int64_t count =
    mongoc_collection_estimated_document_count(collection, opts, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(opts);

API 文档

要学习；了解有关本指南中讨论的任何函数的更多信息，请参阅以下API文档：

后退

指定要返回的文档

来年

非重复字段值