carta
mongoc_uri_get_option_as_int32(3)

mongoc_uri_get_option_as_int323

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

History

  • Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)

Author

MongoDB, Inc

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