MONGOC_CLIENT_POOL_POP(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💅 MONGOC_CLIENT_POOL_POP 💅

okay bestie, this is a libmongoc page, and it's honestly kind of iconic — no cap.

✨ SYNOPSIS ✨

mongoc_client_t *
mongoc_client_pool_pop (mongoc_client_pool_t *pool);

🌸 DESCRIPTION 🌸

So like, mongoc_client_pool_pop grabs you a mongoc_client_t out of the client pool — or straight up makes you a fresh one if there isn't one lying around. Main character energy, honestly. 🫶

The total number of clients you can make from this pool is capped by the URI option "maxPoolSize", and the default is 100. Once that many clients exist and every single one is in use, mongoc_client_pool_pop just blocks — literally just sits there waiting 😭 — until another thread hands a client back with mongoc_client_pool_push().

Oh and if the "waitQueueTimeoutMS" URI option was set to a positive value, then mongoc_client_pool_pop will return NULL when that timeout expires. So don't panic if you get a NULL back, that's the timeout doing its thing. 💀

The mongoc_client_t you get back must be returned to the pool with mongoc_client_pool_push(). Like, that's the whole deal.

NOTE: 🎀 Return a checked out mongoc_client_t to the pool with mongoc_client_pool_push() quickly to encourage reuse of clients among threads. Basically don't be the person who hogs the client, bestie — share the wealth ✨

🦋 PARAMETERS 🦋

  • pool: A mongoc_client_pool_t. That's the pool you're popping from, duh 💅

⭐ RETURNS ⭐

A mongoc_client_t. 🎀

🔥 THREAD SAFETY 🔥

This function is safe to call from multiple threads. Slay, concurrent besties. 👑

💜 AUTHOR 💜

MongoDB, Inc

2009-present, MongoDB, Inc.

okay that's the whole page, mwah 💋 — this was libmongoc version 2.5.6, dated Oct 09, 2026. go forth and pop those clients, bestie 🦋💖

📦 where this page comes from