读取数据

Overview

在此页面上，您可以查看可复制的代码示例，这些示例显示了可用于通过C驱动程序检索文档的常用函数。

提示

要学习；了解有关此页面上显示的任何功能的更多信息，请参阅每个部分中提供的相关指南的链接。

要使用本页中的示例，请将代码示例复制到示例应用程序或您自己的应用程序中。请务必将代码示例中的所有占位符（例如 <connection string URI> ）替换为 MongoDB 部署的相关值。

示例应用程序

您可以使用以下示例应用程序来测试本页上的代码示例。要使用示例应用程序，请执行以下步骤：

确保已安装C驱动程序。
复制以下代码并将其粘贴到新的.c文件中。
从此页面复制代码示例，并将其粘贴到文件中的指定行。

1 #include <bson/bson.h>
2 #include <mongoc/mongoc.h>
3 #include <stdio.h>
4 
5 int
6 main(void)
7 {
8     char *str;
9     bson_error_t error;
10 
11     mongoc_init();
12 
13     mongoc_client_t *client = mongoc_client_new("<connection string URI>");
14     mongoc_collection_t *collection = mongoc_client_get_collection(client, "<database name>", "collection name");
15 
16     // Start example code here
17 
18     // End example code here
19 
20     mongoc_collection_destroy(collection);
21     mongoc_client_destroy(client);
22     mongoc_cleanup();
23 
24     return EXIT_SUCCESS;
25 }

提示

有关如何安装C驱动程序的说明，请参阅入门指南中的下载和安装。

查找文档

以下示例检索与给定过滤指定的条件相匹配的文档列表：

bson_t *query = bson_new();
// Add fields to query here
mongoc_cursor_t* results = mongoc_collection_find_with_opts(collection, query, NULL, NULL);
const bson_t *doc;
while (mongoc_cursor_next(results, &doc)) {
    char *str = bson_as_canonical_extended_json(doc, NULL);
    printf("%s\n", str);
    bson_free(str);
}
mongoc_cursor_destroy(results);
bson_destroy(query);

要学习；了解有关mongoc_collection_find_with_opts() 函数的更多信息，请参阅“查找文档”指南。

对集合中的文档进行计数

以下示例返回指定集合中的文档数：

bson_t *query = bson_new();
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 *query = bson_new();
// Add fields to query here
int64_t count =
    mongoc_collection_count_documents(collection, query, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(query);

要学习；了解有关mongoc_collection_count_documents() 函数的更多信息，请参阅《计数文档》指南中的《检索准确计数》部分。

估计文档计数

以下示例根据集合元数据返回指定集合中文档的大致数量：

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

要学习；了解有关mongoc_collection_estimated_document_count() 函数的更多信息，请参阅《计数文档》指南中的“检索估计计数”部分。

Retrieve Distinct Values

以下示例返回给定集合中指定字段名称的所有非重复值：

bson_t reply;
bson_t *command = BCON_NEW("distinct",
                    BCON_UTF8("<collection name>"),
                    "key",
                    BCON_UTF8("<field name>"));
if (!mongoc_collection_read_command_with_opts(collection, command, NULL, NULL, &reply, &error)) {
    fprintf(stderr, "An error occurred: %s\n", error.message);
} else {
    char *str = bson_as_canonical_extended_json(&reply, NULL);
    printf("%s\n", str);
    bson_free(str);
}
bson_destroy(&reply);
bson_destroy(command);

要学习；了解有关distinct 命令的更多信息，请参阅《检索不同字段值》指南。

监控数据变化

以下示例为给定集合创建变更流，并打印该集合中的后续变更事件：

mongoc_change_stream_t *change_stream;
bson_t *pipeline = bson_new();
// Add stages to pipeline here
const bson_t *doc;
change_stream = mongoc_collection_watch(collection, pipeline, NULL);
while (mongoc_change_stream_next(change_stream, &doc)) {
  char *str = bson_as_canonical_extended_json(doc, NULL);
  printf("Change: %s\n", str);
  bson_free(str);
}
bson_destroy(pipeline);
mongoc_change_stream_destroy(change_stream);

要学习；了解有关mongoc_collection_watch() 函数的更多信息，请参阅《监控数据更改》指南。

后退

Insert

来年

指定查询

1	#include <bson/bson.h>
2	#include <mongoc/mongoc.h>
3	#include <stdio.h>
4
5	int
6	main(void)
7	{
8	char *str;
9	bson_error_t error;
10
11	mongoc_init();
12
13	mongoc_client_t *client = mongoc_client_new("<connection string URI>");
14	mongoc_collection_t *collection = mongoc_client_get_collection(client, "<database name>", "collection name");
15
16	// Start example code here
17
18	// End example code here
19
20	mongoc_collection_destroy(collection);
21	mongoc_client_destroy(client);
22	mongoc_cleanup();
23
24	return EXIT_SUCCESS;
25	}