Scroll to navigation

MONGOC_DATABASE_CREATE_COLLECTION(3) libmongoc MONGOC_DATABASE_CREATE_COLLECTION(3)

NAME

mongoc_database_create_collection - mongoc_database_create_collection()

SYNOPSIS

mongoc_collection_t *
mongoc_database_create_collection (mongoc_database_t *database,

const char *name,
const bson_t *opts,
bson_error_t *error)
BSON_GNUC_WARN_UNUSED_RESULT;


PARAMETERS

  • database: A mongoc_database_t.
  • name: The name of the new collection.
  • opts: An optional bson_t for opts to the create command.
  • error: A location for a bson_error_t or NULL.

DESCRIPTION

This function creates a mongoc_collection_t from the given mongoc_database_t.

If no write concern is provided in opts, the database's write concern is used.

The encryptedFields document in opts may be used to create a collection used for Using Client-Side Field Level Encryption.

For a list of all options, see the MongoDB Manual entry on the create command.

ERRORS

Errors are propagated via the error parameter.

RETURNS

This function returns a newly allocated mongoc_collection_t upon success, NULL upon failure and error is set.

AUTHOR

MongoDB, Inc

COPYRIGHT

2017-present, MongoDB, Inc

August 31, 2022 1.23.0