# mongoc_collection_stats()

## Synopsis

    bool
    mongoc_collection_stats (mongoc_collection_t *collection,
                             const bson_t *options,
                             bson_t *reply,
                             bson_error_t *error) BSON_GNUC_DEPRECATED;

## Deprecated

This helper function is deprecated and should not be used in new code. Run the collStats command directly with mongoc_client_read_command_with_opts() instead.

## Parameters

- `collection`: A mongoc_collection_t.

- `options`: An optional `bson_t` containing extra options to pass to the `collStats` command.

- `reply`: An uninitialized `bson_t` to store the result.

- `error`: An optional location for a bson_error_t or `NULL`.

## Description

Run the `collStats` command to retrieve statistics about the collection.

The command uses the mongoc_read_prefs_t set on `collection`.

## Errors

Errors are propagated via the `error` parameter.

## Returns

Returns `true` if successful. Returns `false` and sets `error` if there are invalid arguments or a server or network error.

`reply` is always initialized and must be freed with `bson_destroy()`.