manpages

mongoc_bulk_operation_replace_one(3)

MONGOC_BULK_OPERATION_REPLACE_ONE(3) libmongoc MONGOC_BULK_OPERATION_REPLACE_ONE(3)

SYNOPSIS

void
mongoc_bulk_operation_replace_one (mongoc_bulk_operation_t *bulk,


                                   const bson_t *selector,


                                   const bson_t *document,


                                   bool upsert);


Replace a single document as part of a bulk operation. This only queues the operation. To execute it, call mongoc_bulk_operation_execute() <>.

This function is superseded by mongoc_bulk_operation_replace_one_with_opts() <>.

PARAMETERS

  • bulk: A mongoc_bulk_operation_t <>.
  • selector: A bson_t <https://www.mongoc.org/libbson/current/bson_t.html> that selects which document to remove.
  • document: A bson_t <https://www.mongoc.org/libbson/current/bson_t.html> containing the replacement document.
  • upsert: true if this should be an upsert.

Warning:

document may not contain fields with keys containing . or $.


ERRORS

Errors are propagated via mongoc_bulk_operation_execute() <>.

See also:

mongoc_bulk_operation_replace_one_with_opts() <>



Author

MongoDB, Inc

Copyright

2009-present, MongoDB, Inc.

February 10, 2026 1.30.7