.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "MONGOC_CLIENT_GET_DEFAULT_DATABASE" "3" "Oct 20, 2022" "1.23.1" "libmongoc"
.SH NAME
mongoc_client_get_default_database \- mongoc_client_get_default_database()
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
mongoc_database_t *
mongoc_client_get_default_database (mongoc_client_t *client)
   BSON_GNUC_WARN_UNUSED_RESULT;
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Get the database named in the MongoDB connection URI, or \fBNULL\fP if the URI specifies none.
.sp
Useful when you want to choose which database to use based only on the URI in a configuration file.
.SH PARAMETERS
.INDENT 0.0
.IP \(bu 2
\fBclient\fP: A \fI\%mongoc_client_t\fP\&.
.UNINDENT
.SH RETURNS
.sp
A newly allocated \fI\%mongoc_database_t\fP that should be freed with \fI\%mongoc_database_destroy()\fP\&.
.SH EXAMPLE
.sp
Default Database Example
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
/* default database is "db_name" */
mongoc_client_t *client = mongoc_client_new ("mongodb://host/db_name");
mongoc_database_t *db = mongoc_client_get_default_database (client);

assert (!strcmp ("db_name", mongoc_database_get_name (db)));

mongoc_database_destroy (db);
mongoc_client_destroy (client);

/* no default database */
client = mongoc_client_new ("mongodb://host/");
db = mongoc_client_get_default_database (client);

assert (!db);

mongoc_client_destroy (client);
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHOR
MongoDB, Inc
.SH COPYRIGHT
2017-present, MongoDB, Inc
.\" Generated by docutils manpage writer.
.