mongoc_collection_create_bulk_operation() — MongoDB C Driver 1.9.2

- MongoDB C Driver 1.9.2 »
- API Reference »
- mongoc_collection_t

# mongoc_collection_create_bulk_operation()

## Synopsis

    mongoc_bulk_operation_t *
    mongoc_collection_create_bulk_operation (
       mongoc_collection_t *collection,
       bool ordered,
       const mongoc_write_concern_t *write_concern) BSON_GNUC_WARN_UNUSED_RESULT
       BSON_GNUC_DEPRECATED_FOR (mongoc_collection_create_bulk_operation_with_opts);

## Deprecated

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

Please use mongoc_collection_create_bulk_operation_with_opts() instead.

## Parameters

- `collection`: A mongoc_collection_t.
- `ordered`: If the operations must be performed in order.
- `write_concern`: An optional mongoc_write_concern_t or `NULL`.

## Description

This function shall begin a new bulk operation. After creating this you may call various functions such as mongoc_bulk_operation_update(), mongoc_bulk_operation_insert() and others.

After calling mongoc_bulk_operation_execute() the commands will be executed in as large as batches as reasonable by the client.

If `ordered` is true, then processing will stop at the first error.

If `ordered` is not true, then the bulk operation will attempt to continue processing even after the first failure.

`write_concern` contains the write concern for all operations in the bulk operation. If `NULL`, the collection’s write concern is used. The global default is acknowledged writes: MONGOC_WRITE_CONCERN_W_DEFAULT.

## See Also

Bulk Write Operations

mongoc_bulk_operation_t

## Errors

Errors are propagated when executing the bulk operation.

## Returns

A newly allocated mongoc_bulk_operation_t that should be freed with mongoc_bulk_operation_destroy() when no longer in use.

Warning

Failure to handle the result of this function is a programming error.

Created using Sphinx 1.6.5, based on Sphinx Readable Theme.