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.

2.2.1                                             Dec 11, 2025              MONGOC_BULK_OPERATION_REPLACE_ONE(3)