manpages

mongoc_collection_save(3)

MONGOC_COLLECTION_SAVE(3) libmongoc MONGOC_COLLECTION_SAVE(3)

Warning:

Deprecated since version 1.9.0: Use mongoc_collection_insert_one() <> or mongoc_collection_replace_one() <> with "upsert" instead.



SYNOPSIS

bool
mongoc_collection_save (mongoc_collection_t *collection,


                        const bson_t *document,


                        const mongoc_write_concern_t *write_concern,


                        bson_error_t *error);


PARAMETERS

  • collection: A mongoc_collection_t <>.
  • document: A bson_t <https://www.mongoc.org/libbson/current/bson_t.html> containing the document.
  • write_concern: A mongoc_write_concern_t <> or NULL for default write concern.
  • error: An optional location for a bson_error_t <> or NULL.

DESCRIPTION

This function shall save a document into collection. If the document has an _id field it will be updated. Otherwise it will be inserted.

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.

Author

MongoDB, Inc

Copyright

2009-present, MongoDB, Inc.

February 10, 2026 1.30.7