MONGOC_COLLECTION_FIND_AND_MODIFY - Online Linux Manual PageSection : 3
Updated : Feb 04, 2021
Source : 1.17.4
Note : libmongoc
NAMEmongoc_collection_find_and_modify − mongoc_collection_find_and_modify()
SYNOPSIS bool
mongoc_collection_find_and_modify (mongoc_collection_t *collection,
const bson_t *query,
const bson_t *sort,
const bson_t *update,
const bson_t *fields,
bool _remove,
bool upsert,
bool _new,
bson_t *reply,
bson_error_t *error);
PARAMETERS • collection: A mongoc_collection_t. • query: A bson_t containing the query to locate target document(s). • sort: A bson_t containing the sort order for query. • update: A bson_t containing an update spec. • fields: An optional bson_t containing the fields to return or NULL. • _remove: If the matching documents should be removed. • upsert: If an upsert should be performed. • _new: If the new version of the document should be returned. • reply: Optional pointer to an uninitialized bson_t that will be initialized with the result. • error: An optional location for a bson_error_t or NULL.
DESCRIPTIONUpdate and return an object. This is a thin wrapper around the findAndModify command. Either update or _remove arguments are required. See also: mongoc_collection_find_and_modify_with_opts. As of MongoDB 3.2, the mongoc_write_concern_t specified on the mongoc_collection_t will be used, if any. reply is always initialized, and must be freed with bson_destroy().
ERRORSErrors are propagated via the error parameter.
RETURNSReturns either the document before or after modification based on the _new parameter. A write concern timeout or write concern error is considered a failure.
EXAMPLEfind−and−modify.c #include <mongoc/mongoc.h>
#include <stdio.h>
int
main (int argc, char *argv[])
{
mongoc_collection_t *collection;
mongoc_client_t *client;
const char *uri_string =
"mongodb://127.0.0.1:27017/?appname=find−and−modify−example";
mongoc_uri_t *uri;
bson_error_t error;
bson_t *query;
bson_t *update;
bson_t reply;
char *str;
mongoc_init ();
uri = mongoc_uri_new_with_error (uri_string, &error);
if (!uri) {
fprintf (stderr,
"failed to parse URI: %s\n"
"error message: %s\n",
uri_string,
error.message);
return EXIT_FAILURE;
}
client = mongoc_client_new_from_uri (uri);
if (!client) {
return EXIT_FAILURE;
}
mongoc_client_set_error_api (client, 2);
collection = mongoc_client_get_collection (client, "test", "test");
/*
* Build our query, {"cmpxchg": 1}
*/
query = BCON_NEW ("cmpxchg", BCON_INT32 (1));
/*
* Build our update. {"$set": {"cmpxchg": 2}}
*/
update = BCON_NEW ("$set", "{", "cmpxchg", BCON_INT32 (2), "}");
/*
* Submit the findAndModify.
*/
if (!mongoc_collection_find_and_modify (collection,
query,
NULL,
update,
NULL,
false,
false,
true,
&reply,
&error)) {
fprintf (stderr, "find_and_modify() failure: %s\n", error.message);
return EXIT_FAILURE;
}
/*
* Print the result as JSON.
*/
str = bson_as_canonical_extended_json (&reply, NULL);
printf ("%s\n", str);
bson_free (str);
/*
* Cleanup.
*/
bson_destroy (query);
bson_destroy (update);
bson_destroy (&reply);
mongoc_collection_destroy (collection);
mongoc_uri_destroy (uri);
mongoc_client_destroy (client);
mongoc_cleanup ();
return EXIT_SUCCESS;
}
AUTHORMongoDB, Inc
COPYRIGHT2017-present, MongoDB, Inc 0
Johanes Gumabo
Data Size : 16,352 byte
man-mongoc_collection_find_and_modify.3Build : 2024-12-05, 20:55 :
Visitor Screen : x
Visitor Counter ( page / site ) : 3 / 188,074
Visitor ID : :
Visitor IP : 3.149.254.229 :
Visitor Provider : AMAZON-02 :
Provider Position ( lat x lon ) : 39.962500 x -83.006100 : x
Provider Accuracy Radius ( km ) : 1000 :
Provider City : Columbus :
Provider Province : Ohio , : ,
Provider Country : United States :
Provider Continent : North America :
Visitor Recorder : Version :
Visitor Recorder : Library :
Online Linux Manual Page : Version : Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page : Library : lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page : Library : lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base : Version : Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base : Library : lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.