MONGOC_DATABASE_SET_READ_PREFS(3)

💅 MONGOC_DATABASE_SET_READ_PREFS(3) 💅

okay so bestie, welcome to libmongoc — yes that's the C driver for MongoDB and yes we're about to make your database read from exactly where you tell it to. no cap, this one's actually simple and it slays 🫶

---

✨ SYNOPSIS ✨

void
mongoc_database_set_read_prefs (mongoc_database_t *database,
                                const mongoc_read_prefs_t *read_prefs);

🌸 what it even does 🌸

This function sets the default read preferences to use on operations performed with database. and like — the important part — collections created with mongoc_database_get_collection() after this call will inherit these read preferences. so you're basically setting the vibe for everything that comes next, iykyk 💫

The global default is MONGOC_READ_PRIMARY: if the client is connected to a replica set it reads from the primary, otherwise it reads from the current MongoDB server. that's the out-of-the-box behavior, no notes, it just works 🎀

Please see the MongoDB website for a description of Read Preferences. (fr fr, go read it, it's giving essential context 🌈)

---

🦋 PARAMETERS 🦋

• database: A mongoc_database_t. the database we're setting the vibe for 💜
• read_prefs: A mongoc_read_prefs_t. the read preferences themselves, freshly handed over 👑

---

🧚 AUTHOR 🧚

MongoDB, Inc — iconic, legendary, no further questions 💅

⭐ COPYRIGHT ⭐

2009-present, MongoDB, Inc. — protect it, respect it, it's theirs 🫶

---

lowkey a public service announcement: this just sets the default on database — it doesn't retroactively change collections you already grabbed. timing matters, bestie ⏰

---

and that's the whole page, bestie — you ate 💖 signing off from libmongoc version 2.5.6, dated Oct 09, 2026 — see you in the next manpage, mwah 😭🎀