---
name: "mongoc_gridfs_remove_by_filename"
section: "3"
platform: "linux"
package: "libmongoc-doc"
version: "1.30.4-1+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mongoc_gridfs_remove_by_filename"
---

# mongoc\_gridfs\_remove\_by\_filename(3)

## SYNOPSIS

```
bool
mongoc_gridfs_remove_by_filename (mongoc_gridfs_t *gridfs,
                                  const char *filename,
                                  bson_error_t *error);
```

## PARAMETERS

- •

  **gridfs**: A *mongoc\_gridfs\_t*.

- •

  **filename**: A UTF-8 encoded string containing the filename.

- •

  **error**: An optional location for a *bson\_error\_t* or **NULL**.

## DESCRIPTION

Removes all files matching **filename** and their data chunks from the MongoDB server.

## RETURNS

Returns true if successful, including when no files match. Returns **false** and sets **error** if there are invalid arguments or a server or network error.

## ERRORS

Errors are propagated via the **error** parameter.

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.