mongoc_uri_get_option_as_int32(3)

mongoc_uri_get_option_as_int323

Usage

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.

Overview

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()

Releases

5 releases since Debian 9 (Stretch); the text changed 4 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13

Author

MongoDB, Inc

From libmongoc-doc 1.30.4-1+deb13u3 in Debian 13 (Trixie). Parsed by carta from the page's man source.