MONGOC_CLIENT...NEW_WITH_ERROR(3)

💅 MONGOC_CLIENT...NEW_WITH_ERROR(3) 💅

okay so this is a page from libmongoc, the MongoDB C driver docs, and it's literally about making a client pool without having to guess why it failed. bestie, let's get into it 🫶

---

✨ SYNOPSIS ✨

     mongoc_client_pool_t *
     mongoc_client_pool_new_with_error (const mongoc_uri_t *uri,
                                        bson_error_t *error);

this function creates a new mongoc_client_pool_t using the mongoc_uri_t provided. that's it, that's the whole vibe. no cap 🎀

---

🌸 DESCRIPTION 🌸

so like, you hand it a mongoc_uri_t and it hands you back a shiny new mongoc_client_pool_t. the whole point of this one (iykyk) is that it also takes an error out-param, so when things go sideways you actually get told why instead of just getting a sad little NULL and zero explanation 😭

---

🦋 PARAMETERS 🦋

• uri — a mongoc_uri_t. the actual address/config situation, the main character of this whole thing ✨
• error — an optional location for a bson_error_t, or NULL. optional bestie! pass NULL if you're feeling brave and don't care about the deets 🙈

---

👑 RETURNS 👑

a newly allocated mongoc_client_pool_t that should be freed with mongoc_client_pool_destroy() when no longer in use — yes, that means you are responsible for cleaning up, don't just leave it lying around 💀

on error, NULL is returned and error will be populated with the error description. so check for NULL, read your bson_error_t, and slay accordingly 🔥

fr fr: if you passed NULL for error, you get the NULL return and literally no context. choose wisely 🎀

---

💜 AUTHOR 💜

MongoDB, Inc — icons only 👑

---

🌈 COPYRIGHT 🌈

2009-present, MongoDB, Inc. 🫶

---

and that's the whole page, bestie!! version 2.5.6, dated Oct 09, 2026 — go forth and pool responsibly 💅✨🦋