NAME

       mongoc_collection_create_bulk_operation()   -   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.

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;

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(3)  ,  mongoc_bulk_operation_insert(3)  and
       others.

       After  calling  mongoc_bulk_operation_execute(3) 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.

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(3) when no longer in use.

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

COLOPHON

       This   page   is   part   of   MongoDB   C   Driver.    Please   report   any   bugs    at
       https://jira.mongodb.org/browse/CDRIVER.