MongoDB C Driver¶

Introduction¶

The MongoDB C Driver, also known as “libmongoc”, is the official client library for C applications, and provides a base for MongoDB drivers in higher-level languages.

The library is compatible with all major platforms. It depends on libbson to create and parse BSON data.

• Tutorial
• Usage Guide
• API Reference
• Changelog
• Source Code

Installation¶

See Installing the MongoDB C Driver (libmongoc) and BSON library (libbson).

Connect to MongoDB Atlas¶

To connect to a MongoDB Atlas cluster, use the Atlas connection string for your cluster:

#include <mongoc/mongoc.h>
int
main (int argc, char *argv[])
{
   mongoc_database_t *database;
   mongoc_client_t *client;
   mongoc_init ();
   client = mongoc_client_new(
      "mongodb+srv://<username>:<password>@<cluster-url>/test?retryWrites=true&w=majority"
   );
   database = mongoc_client_get_database (client, "test");
   mongoc_database_destroy (database);
   mongoc_client_destroy (client);
   mongoc_cleanup ();
   return 0;
}

See Advanced Connections for more ways to connect.

Connect to localhost¶

To connect to a database running locally on its default port, change the connection string to "mongodb://localhost".

To connect to a database running locally, change the connection string to "mongodb://localhost:<port>".

Your mongod instance must be running to successfully connect to your database. For information on how to start your mongod instance, see the Manage mongod Processes Server Manual Entry.

Compatibility¶