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.