---
name: "mongoc_uri_new_with_error"
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_new_with_error"
---

# mongoc\_uri\_new\_with\_error(3)

## SYNOPSIS

```
mongoc_uri_t *
mongoc_uri_new_with_error (const char *uri_string,
                           bson_error_t *error);
```

## PARAMETERS

- •

  **uri\_string**: A string containing a URI.

- •

  **error**: An optional location for a *bson\_error\_t* or **NULL**.

## DESCRIPTION

Parses a string containing a MongoDB style URI connection string.

## 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.

## 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"**

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.