mongoc_collection_find_and_modify_with_opts()¶
Synopsis¶
bool
mongoc_collection_find_and_modify_with_opts (
mongoc_collection_t *collection,
const bson_t *query,
const mongoc_find_and_modify_opts_t *opts,
bson_t *reply,
bson_error_t *error);
Parameters¶
collection: A mongoc_collection_t.query: Abson_tcontaining the query to locate target document(s).opts: find and modify optionsreply: An optional location for abson_tthat will be initialized with the result orNULL.error: An optional location for a bson_error_t orNULL.
Description¶
Update and return an object.
Errors¶
Errors are propagated via the error parameter.
Returns¶
Returns true if successful. Returns false and sets error if there are invalid arguments or a server or network error.
A write concern timeout or write concern error is considered a failure.
Example¶
See the example code for mongoc_find_and_modify_opts_t.