1MONGOC_COLLECTION_FIND_AND_MODIFYM_OWNIlGTiOHbC_m_OoCPnOTgLSoL(cE3C)TION_FIND_AND_MODIFY_WITH_OPTS(3)
2
3
4

NAME

6       mongoc_collection_find_and_modify_with_opts       -      mongoc_collec‐
7       tion_find_and_modify_with_opts()
8

SYNOPSIS

10          bool
11          mongoc_collection_find_and_modify_with_opts (
12             mongoc_collection_t *collection,
13             const bson_t *query,
14             const mongoc_find_and_modify_opts_t *opts,
15             bson_t *reply,
16             bson_error_t *error);
17

PARAMETERS

19       • collection: A mongoc_collection_t.
20
21       • query: A bson_t containing the query to locate target document(s).
22
23       • opts: A find and modify options. Must not be NULL.
24
25       • reply: An optional location for a bson_t  that  will  be  initialized
26         with the result or NULL.
27
28       • error: An optional location for a bson_error_t or NULL.
29

DESCRIPTION

31       Update and return an object.
32
33       reply is always initialized, and must be freed with bson_destroy().
34
35       If    an    unacknowledged    write    concern    is    set    (through
36       mongoc_find_and_modify_opts_append()), the output reply  is  always  an
37       empty document.
38
39       On success, the output reply contains the full server reply to the fin‐
40       dAndModify command. See the MongoDB Manual page for  findAndModify  for
41       the expected server reply.
42

ERRORS

44       Errors are propagated via the error parameter.
45

RETURNS

47       Returns  true  if successful. Returns false and sets error if there are
48       invalid arguments or a server or network error.
49
50       A write concern timeout or write concern error is considered a failure.
51

EXAMPLE

53       See the example code for mongoc_find_and_modify_opts_t.
54

AUTHOR

56       MongoDB, Inc
57

59       2017-present, MongoDB, Inc
60
61
62
63
641.24.3                          MAOuNgGO1C7_,CO2L0L2E3CTION_FIND_AND_MODIFY_WITH_OPTS(3)
Impressum