mongoc_uri_t *
Contents
Copyright
2009-present, MongoDB, Inc.
1.30.4 Jun 08, 2025 MONGOC_URI_NEW_WITH_ERROR(3)
Description
Parses a string containing a MongoDB style URI connection string.
Examples
Examples of some valid MongoDB connection strings can be seen below.
"mongodb://localhost/""mongodb://localhost/?replicaSet=myreplset""mongodb://myuser:mypass@localhost/""mongodb://kerberosuser%40EXAMPLE.COM@example.com/?authMechanism=GSSAPI""mongodb://[::1]:27017/""mongodb://10.0.0.1:27017,10.0.0.1:27018,[::1]:27019/?tls=true""mongodb://%2Ftmp%2Fmongodb-27017.sock""mongodb://user:pass@%2Ftmp%2Fmongodb-27017.sock""mongodb://localhost,[::1]/mydb?authSource=mydb"Parameters
• uri_string: A string containing a URI.
• error: An optional location for a bson_error_t or NULL.
Returns
A newly allocated mongoc_uri_t if successful. Otherwise NULL populating error with the error description.
WARNING:
Failure to handle the result of this function is a programming error.
Synopsis
mongoc_uri_t *
mongoc_uri_new_with_error (const char *uri_string,
bson_error_t *error);
