NAME

       mongoc_gridfs_bucket_new - mongoc_gridfs_bucket_new()

SYNOPSIS

          mongoc_gridfs_bucket_t *
          mongoc_gridfs_bucket_new (mongoc_database_t *db,
                                    const bson_t *opts,
                                    const mongoc_read_prefs_t *read_prefs,
                                    bson_error_t* error) BSON_GNUC_WARN_UNUSED_RESULT;

PARAMETERS

       • db: A mongoc_database_t.

       • opts: A bson_t or NULL

       • read_prefs:  A  mongoc_read_prefs_t  used  for  read  operations or NULL to inherit read
         preferences from db.

       • error: A bson_error_t or NULL.

       opts may be NULL or a BSON document with additional command options:

       • bucketName: A UTF-8 string used as  the  prefix  to  the  GridFS  "chunks"  and  "files"
         collections.  Defaults  to  "fs". The bucket name, together with the database and suffix
         collections must not exceed 120 characters. See the manual for the max namespace length.

       • chunkSizeBytes: An int32 representing the chunk size. Defaults to 255KB.

       • writeConcern: Construct a mongoc_write_concern_t and  use  mongoc_write_concern_append()
         to    add    the    write    concern    to    opts.    See    the   example   code   for
         mongoc_client_write_command_with_opts().

       • readConcern: Construct a mongoc_read_concern_t and use  mongoc_read_concern_append()  to
         add     the     read     concern     to    opts.    See    the    example    code    for
         mongoc_client_read_command_with_opts(). Read concern  requires  MongoDB  3.2  or  later,
         otherwise an error is returned.

DESCRIPTION

       Creates a new mongoc_gridfs_bucket_t. Use this handle to perform GridFS operations.

RETURNS

       A    newly    allocated    mongoc_gridfs_bucket_t    that    should    be    freed    with
       mongoc_gridfs_bucket_destroy() or NULL on failure.

AUTHOR

       MongoDB, Inc

COPYRIGHT

       2017-present, MongoDB, Inc