---
name: "mongoc_client_encryption_encrypt_range_opts_set_trim_factor"
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_client_encryption_encrypt_range_opts_set_trim_factor"
---

# mongoc\_client\_encryption\_encrypt\_range\_opts\_set\_trim\_factor(3)

## SYNOPSIS

```
void
mongoc_client_encryption_encrypt_range_opts_set_trim_factor (
     mongoc_client_encryption_encrypt_range_opts_t *range_opts, int32_t trim_factor);
```

Added in version 1.28.0.

Sets trim factor for explicit encryption. Only applies when the algorithm set by *mongoc\_client\_encryption\_encrypt\_opts\_set\_algorithm()* is "Range". It is an error to set trim factor when algorithm is not "Range".

The trim factor may be used to tune performance. When omitted, a default value is used.

Trim factor must match the value set in the encryptedFields of the destination collection. It is an error to set a different value.

## PARAMETERS

- •

  **range\_opts**: A *mongoc\_client\_encryption\_encrypt\_range\_opts\_t*

- •

  **trim\_factor**: A non-negative trim factor.

**SEE ALSO:**

```
mongoc_client_encryption_encrypt_range_opts_t
```

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.