指定要返回的字段

样本数据

本指南中的示例使用 Atlas示例数据集的sample_restaurants数据库中的 restaurants集合。 要从C++应用程序访问权限此集合，请实例化一个连接到Atlas 集群的mongocxx::client ，并将以下值分配给db和collection变量：

auto db = client["sample_restaurants"];
auto collection = db["restaurants"];

要学习；了解如何创建免费的MongoDB Atlas 群集并加载示例数据集，请参阅Atlas入门指南。

指定要包含的字段

要指定结果中包含的字段，请创建mongocxx::options::find类的实例并设立其projection字段。 要设立此字段，请使用以下语法：

<options instance>.projection(make_document(kvp("<field name>", 1)));

以下示例将mongocxx::options::find对象的projection字段设置为仅返回匹配文档的name 、 cuisine和borough字段。 然后，它调用find()方法查找name字段值为"Emerald Pub"的所有餐厅，并将mongocxx::options::find对象作为参数传递给find() ：

mongocxx::options::find opts{};
opts.projection(make_document(kvp("name", 1), kvp("cuisine", 1), kvp("borough", 1)));
auto cursor = collection.find(make_document(kvp("name", "Emerald Pub")), opts);
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : { "$oid" : "..." }, "borough" : "Manhattan", "cuisine" : "American", "name" : "Emerald Pub" }
{ "_id" : { "$oid" : "..." }, "borough" : "Queens", "cuisine" : "American", "name" : "Emerald Pub" }

当您使用投影指定要包含在返回文档中的字段时，默认情况下还会包含_id字段。 所有其他字段均会隐式排除。 要从返回文档中删除_id字段，您必须明确将其排除。

排除_id 字段

在指定要包含的字段时，您还可以从返回的文档中排除_id字段。

以下示例执行与上一示例相同的查询，但从投影中排除_id字段：

mongocxx::options::find opts{};
opts.projection(make_document(kvp("_id", 0), kvp("name", 1), kvp("cuisine", 1), kvp("borough", 1)));
auto cursor = collection.find(make_document(kvp("name", "Emerald Pub")), opts);
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "borough" : "Manhattan", "cuisine" : "American", "name" : "Emerald Pub" }
{ "borough" : "Queens", "cuisine" : "American", "name" : "Emerald Pub" }

指定要排除的字段

要指定要在结果中排除的字段，请创建mongocxx::options::find类的实例并设立其projection字段。 要设立此字段，请使用以下语法：

<options instance>.projection(make_document(kvp("<field name>", 0)));

以下示例将mongocxx::options::find对象的projection字段设置为排除匹配文档的grades和address字段。 然后，它调用find()方法查找name字段值为"Emerald Pub"的所有餐厅，并将mongocxx::options::find对象作为参数传递给find() ：

mongocxx::options::find opts{};
opts.projection(make_document(kvp("grades", 0), kvp("address", 0)));
auto cursor = collection.find(make_document(kvp("name", "Emerald Pub")), opts);
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : { "$oid" : "..." }, "borough" : "Manhattan", "cuisine" : "American", "name" : "Emerald Pub", "restaurant_id" : "40367329" }
{ "_id" : { "$oid" : "..." }, "borough" : "Queens", "cuisine" : "American", "name" : "Emerald Pub", "restaurant_id" : "40668598" }

当您使用投影指定要排除的字段时，任何未指定的字段都将隐式包含在返回文档中。

API 文档

要进一步了解本指南所讨论的任何方法或类型，请参阅以下 API 文档：

• find()

• mongocxx::options::find

• 投影