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.

MongoDB C Driver                                   2016‐01‐18         MONGOC_COLLECTION_CREATE_BULK_OPERATION(3)