table of contents
| MONGOC_DATABASE_CREATE_COLLECTION(3) | libmongoc | MONGOC_DATABASE_CREATE_COLLECTION(3) |
SYNOPSIS¶
mongoc_collection_t * mongoc_database_create_collection (mongoc_database_t *database,
const char *name,
const bson_t *opts,
bson_error_t *error);
PARAMETERS¶
- database: A mongoc_database_t <>.
- name: The name of the new collection.
- opts: An optional bson_t <https://www.mongoc.org/libbson/current/bson_t.html> 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 Queryable Encryption <https://www.mongodb.com/docs/languages/c/c-driver/current/libmongoc/guides/queryable-encryption/>.
For a list of all options, see the MongoDB Manual entry on the create command <https://www.mongodb.com/docs/manual/reference/command/create/>.
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¶
2009-present, MongoDB, Inc.
| December 11, 2025 | 2.2.1 |