mongoc_collection_insert_bulk man page

mongoc_collection_insert_bulk — mongoc_collection_insert_bulk()

Synopsis

bool
mongoc_collection_insert_bulk (mongoc_collection_t *collection,
                               mongoc_insert_flags_t flags,
                               const bson_t **documents,
                               uint32_t n_documents,
                               const mongoc_write_concern_t *write_concern,
                               bson_error_t *error)
   BSON_GNUC_DEPRECATED_FOR (mongoc_collection_create_bulk_operation);

Deprecated

This function is deprecated and should not be used in new code.

Please use mongoc_collection_create_bulk_operation() instead.

Parameters

  • collection: A mongoc_collection_t.

  • flags: A bitwise or of mongoc_insert_flags_t.

  • documents: An array of bson_t.

  • n_documents: The number of documents in documents.

  • write_concern: A mongoc_write_concern_t or NULL.

  • error: An optional location for a bson_error_t or NULL.

Description

This function performs a bulk insert of all of the documents in documents. This function is deprecated as it cannot accurately return which documents may have failed during the bulk insert.

Errors

Errors are propagated via the error parameter.

A write concern timeout or write concern error is considered a failure.

Returns

true if successful, otherwise false and error is set.

Author

MongoDB, Inc

Info

Mar 08, 2017 1.6.1 MongoDB C Driver