---
name: "mongoc_uri_get_option_as_int32"
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_uri_get_option_as_int32"
---

# mongoc\_uri\_get\_option\_as\_int32(3)

## SYNOPSIS

```
int32_t
mongoc_uri_get_option_as_int32 (const mongoc_uri_t *uri,
                                const char *option,
                                int32_t fallback);
```

## PARAMETERS

- •

  **uri**: A *mongoc\_uri\_t*.

- •

  **option**: The name of an option, case insensitive.

- •

  **fallback**: A default value to return.

## DESCRIPTION

Returns the value of the URI option if it is set and of the correct type (integer). Returns **fallback** if the option is not set, set to an invalid type, or zero.

Zero is considered "unset", so URIs can be constructed like so, and still accept default values:

```
bson_strdup_printf ("mongodb://localhost/?connectTimeoutMS=%d", myvalue)
```

If **myvalue** is non-zero it is the connection timeout; if it is zero the driver uses the default timeout.

When reading an option that is an int64, this function will return the value as **int32\_t**. If the value is outside the range of a 32-bit integer, a warning will be emitted and **fallback** is returned instead.

**SEE ALSO:**

```
mongoc_uri_get_option_as_int64()
```

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.