Especifica los documentos a devolver

Overview

En esta guía, puedes aprender a especificar qué documentos devolver de una operación de lectura utilizando los siguientes métodos:

• mongocxx::options::find::limit(): Especifica el número máximo de documentos que se devolverán de una query.

• mongocxx::options::find::sort(): Especifica el orden de clasificación para los documentos devueltos.

• mongocxx::options::find::skip(): Especifica el número de documentos que se debe omitir antes de devolver los resultados de la query.

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

Limit

Para especificar el número máximo de documentos devueltos en una operación de lectura, cree una instancia de la clase mongocxx::options::find y establezca su campo limit. Luego, pasa tu instancia de mongocxx::options::find como argumento al método find().

El siguiente ejemplo encuentra todos los restaurantes que tienen un valor de campo cuisine de "Italian" y limita los resultados a 5 documentos:

mongocxx::options::find opts{};
opts.limit(5);
auto cursor = collection.find(make_document(kvp("cuisine", "Italian")), opts);
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : { "$oid" : "..." }, ..., "name" : "Philadelphia Grille Express", "restaurant_id" : "40364305" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Isle Of Capri Restaurant", "restaurant_id" : "40364373" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Marchis Restaurant", "restaurant_id" : "40364668" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Crystal Room", "restaurant_id" : "40365013" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Forlinis Restaurant", "restaurant_id" : "40365098" }

Sort

Para devolver documentos en un orden especificado, cree un documento que incluya el campo por el cual ordenar los resultados y la dirección de orden. Un valor de 1 ordena los valores de menor a mayor, y un valor de -1 los ordena de mayor a menor. Luego, llama al método mongocxx::options::find::sort() en una instancia de mongocxx::options::find y pasar este documento como argumento.

El siguiente ejemplo devuelve todos los documentos que tienen un valor de cuisine igual a "Italian", ordenados en orden ascendente según los valores del campo name:

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

{ "_id" : { "$oid" : "..." }, ..., "name" : "(Lewis Drug Store) Locanda Vini E Olii", "restaurant_id" : "40804423" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "101 Restaurant And Bar", "restaurant_id" : "40560108" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "44 Sw Ristorante & Bar", "restaurant_id" : "40698807" }
...
{ "_id" : { "$oid" : "..." }, ..., "name" : "Zucchero E Pomodori", "restaurant_id" : "41189590" }

Omitir

Para omitir un número especificado de documentos antes de devolver los resultados de la consulta, crea una instancia de la clase mongocxx::options::find y define su campo skip. Luego, pasa tu instancia mongocxx::options::find como argumento al método find().

El siguiente ejemplo devuelve todos los documentos que tienen un valor de campo borough de "Manhattan" y omite los primeros 10 documentos:

mongocxx::options::find opts{};
opts.skip(10);
auto cursor = collection.find(make_document(kvp("borough", "Manhattan")), opts);
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : { "$oid" : "..." }, ...,  "name" : "Cafe Metro", "restaurant_id" : "40363298" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Lexler Deli", "restaurant_id" : "40363426" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Domino'S Pizza", "restaurant_id" : "40363644" }
...

Combine Limit, Sort y Skip

Puedes configurar los campos limit, sort y skip de una sola instancia de mongocxx::options::find. Esto permite establecer un número máximo de documentos ordenados para devolver, omitiendo un número especificado de documentos antes de la devolución.

El siguiente ejemplo devuelve 5 documentos que tienen un valor de cuisine igual a "Italian". Los resultados están clasificados en orden ascendente por el valor del campo name, omitiendo los primeros 10 documentos:

mongocxx::options::find opts{};
opts.sort(make_document(kvp("name", 1))).limit(5).skip(10);
auto cursor = collection.find(make_document(kvp("cuisine", "Italian")), opts);
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : { "$oid" : "..." }, ..., "name" : "Acqua", "restaurant_id" : "40871070" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Acqua Restaurant", "restaurant_id" : "41591488" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Acqua Santa", "restaurant_id" : "40735858" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Acquista Trattoria", "restaurant_id" : "40813992" }
{ "_id" : { "$oid" : "..." }, ..., "name" : "Acquolina Catering", "restaurant_id" : "41381423" }

Información Adicional

Para obtener más información sobre la recuperación de documentos, consulte la Retrieve Data guide.

Para más información sobre cómo especificar una query, consulta la guía de Especificar una query.