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 optionalbson_tfor opts to thecreatecommand.error: A location for a bson_error_t orNULL.
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.