BSON_APPEND_MINKEY(3)

💅 BSON_APPEND_MINKEY(3) — the libbson one, bestie ✨

okay so picture this: a whole manual page, but make it make sense. it's BSON_APPEND_MINKEY(3) from libbson, and honestly? it's a tiny little icon and we're gonna get into it 🎀

---

✨ SYNOPSIS ✨

like, here's the vibe, verbatim, no notes:

#define BSON_APPEND_MINKEY(b, key) \
   bson_append_minkey (b, key, (int) strlen (key))

bool
bson_append_minkey (bson_t *bson, const char *key, int key_length);

so there's the macro shortcut 🫶 and there's the real function doing the actual work. two for the price of one, we love to see it.

---

🌸 PARAMETERS 🌸

• bson — a bson_t. that's the doc, the canvas, the main character 💖
• key — an ASCII C string holding the name of the field. so like, ASCII only, bestie, don't try anything fancy 😭
• key_length — how many bytes long key is, or hit it with -1 and let it figure the length out with strlen(). convenient fr fr ✨

---

🦋 DESCRIPTION 🦋

so bson_append_minkey() shall append an element of type BSON_TYPE_MINKEY to a bson document. that's the whole gig. no cap 💅

where does this actually get used though? primarily in queries. and — important — it's unlikely to be used when storing a document to MongoDB. so like, if you're out here stuffing minkeys into documents you're saving, that's giving wrong-tool-for-the-job energy, just so you know 🙈

---

🎀 RETURNS 🎀

returns true if the operation was applied successfully 👑 and the function will fail if appending the value grows bson larger than INT32_MAX. so watch the size, bestie, that's the line you do not cross 💀

---

⭐ AUTHOR ⭐

MongoDB, Inc — the whole squad 🫶

---

🌈 COPYRIGHT 🌈

2009-present, MongoDB, Inc. — iconic, long-running, respect the legacy 💜

---

and that's the tea 🍓 this page was served up in version 2.5.6, dated Oct 09, 2026, under the libbson banner — love that for us, mwah 💋✨