table of contents
| 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.
| December 11, 2025 | 2.2.1 |