manpages

mongoc_database_create_collection(3)

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.

February 10, 2026 1.30.7