- MongoDB C Driver 1.13.1 »
- API Reference »
- mongoc_collection_t

# mongoc_collection_rename()

## Synopsis

    bool
    mongoc_collection_rename (mongoc_collection_t *collection,
                              const char *new_db,
                              const char *new_name,
                              bool drop_target_before_rename,
                              bson_error_t *error);

## Parameters

- `collection`: A mongoc_collection_t.
- `new_db`: The name of the new database.
- `new_name`: The new name for the collection.
- `drop_target_before_rename`: If an existing collection matches the new name, drop it before the rename.
- `error`: An optional location for a bson_error_t or `NULL`.

## Description

For more information, see mongoc_collection_rename_with_opts(). This function is a thin wrapper, passing `NULL` in as `bson_t` parameter.

Created using Sphinx 1.8.3, based on Sphinx Readable Theme.