MONGOC_URI_SET_AUTH_MECHANISM(3)

📦
version 2.5.6 · 16 versions
, in epel 10

✨ MONGOC_URI_SET_AUTH_MECHANISM ✨

okay bestie, so this one is from libmongoc and it's literally the little function that lets you swap out your auth mechanism after the URI has already been parsed. glow-up for your connection string, no cap 💅

🌸 SYNOPSIS 🌸

bool
mongoc_uri_set_auth_mechanism (mongoc_uri_t *uri, const char *value);

Like, that's the whole signature. Two arguments, one bool out. simple. iconic. 🎀

🫶 PARAMETERS 🫶

  • uri — a mongoc_uri_t. the URI you're about to mess with, main character energy ✨
  • value — the new "authMechanism" value. the fresh vibe you're giving it 💖

🦋 DESCRIPTION 🦋

So here's the tea: this sets the "authMechanism" URI option — think stuff like "SCRAM-SHA-1" or "GSSAPI" — but the cute part is you do it after the URI has been parsed from a string. like, the string already happened, the parsing already happened, and now you're going back in to change your mind. we love a flexible queen 👑

The way it works: if the option is already set, it updates it in-place. no drama, no duplicates. but if it's not set yet? it appends it to the URI's bson_t of options. so either way you're slaying, it just takes a different path 🛣️💫

⭐ RETURNS ⭐

It returns false if the option just cannot be set — for example, if value is not valid UTF-8. yeah 😭 if your bytes aren't valid UTF-8, she's not doing it, and honestly? fair.

ngl, if you get false back just double check your value is actually valid UTF-8 before you go blaming the library 💀

👑 AUTHOR 👑

MongoDB, Inc 🫡

2009-present, MongoDB, Inc. — all the legal sparkle ✨

and that's the page, bestie! 🍓 this was libmongoc 2.5.6, dated Oct 09, 2026 — love that for us, see you in the next one 🧚‍♀️💜

📦 where this page comes from