MONGOC_CLIENT_...PPEND_METADATA(3)

💅 MONGOC_CLIENT_POOL_APPEND_METADATA(3) 💅

okay so this is the libmongoc manual page for mongoc_client_pool_append_metadata, and bestie, it's the client-pool twin of mongoc_client_append_metadata() — same energy, but for pools. ✨

🌸 SYNOPSIS 🌸

          bool
          mongoc_client_pool_append_metadata (mongoc_client_pool_t *pool,
                                              const char *name,
                                              const char *version,
                                              const char *platform)

This function is identical to mongoc_client_append_metadata() except for client pools. no cap. See mongoc_client_append_metadata() and mongoc_handshake_data_append() for more details.

The updated handshake command applies to the given pool object for connections established after the append took place. So the append has to happen before those connections show up, iykyk. 🕰️

Also note that mongoc_client_append_metadata() cannot be called on a client retrieved from a client pool. That's just not the vibe. 🚫

🎀 PARAMETERS 🎀

• pool — a mongoc_client_pool_t. That's the pool, bestie.
• name — the name of the wrapping driver. It must not be null or an empty string. fr fr, don't try it.
• version — the optional version of the wrapping driver.
• platform — the optional information about the current platform, for example configure options or compile flags.

No string argument may contain the substring " / ", which is used as the delimiter between metadata field values. So keep that exact little space-slash-space out of your strings. 💅

🔥 RETURNS 🔥

This function will log an error and return false when one of the following occurs:

• The resulting handshake document would exceed the size limit.

Otherwise, true if the given fields are set successfully. slay. ✅

🧵 THREAD SAFETY 🧵

This function is safe to call from multiple threads. Go off, concurrent besties. 🧚

👀 SEE ALSO 👀

• mongoc_client_append_metadata()
• mongoc_handshake_data_append()

👑 AUTHOR 👑

MongoDB, Inc

📜 COPYRIGHT 📜

2009-present, MongoDB, Inc.

---

kisses bestie, this page is serving libmongoc 2.5.6, dated Oct 09, 202 — bye 💖🎀🦋