BSON_APPEND_BOOL(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💖 BSON_APPEND_BOOL(3) 💖

okay bestie, so this is a page from libbson — it's the BSON_APPEND_BOOL(3) situation and honestly it's a short one, so we're gonna get through it together, no stress 🫶

✨ SYNOPSIS ✨

you got two flavors, the macro and the real one:

#define BSON_APPEND_BOOL(b, key, val) \
   bson_append_bool (b, key, (int) strlen (key), val)

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

the macro is giving "convenience era" — it literally just fills in the length for you with strlen. iconic 💅

🌸 PARAMETERS 🌸

  • bson — a bson_t. it's the doc you're stuffing stuff into, the main character of the whole operation 👑
  • key — the name of the field. what you're calling it, bestie ✨
  • key_length — the length of key, or -1 if you want it to just use strlen(). lowkey the lazy-but-valid route, we respect it 🙈
  • value — true or false. that's it. that's the whole vibe check — it's a bool, there's only two options 💀

🦋 DESCRIPTION 🦋

so bson_append_bool() shall append a new element to bson containing the boolean you handed it. yes, "shall" — very official of it. it's just adding a lil true-or-false to your document and calling it a day. no cap, that's the whole thing 🌈

⭐ RETURNS ⭐

it returns true if the operation was applied successfully 💖

but heads up — it will fail if appending the value grows bson larger than INT32_MAX. that's the line, bestie, don't cross it. big numbers are not it here 😭🔥

🎀 AUTHOR 🎀

MongoDB, Inc — the ones who brought you this whole libbson moment 💜

2009-present, MongoDB, Inc. — yeah, they've been at it a minute. legends, honestly 🫡

and that's the page, bestie!! short and sweet. anyway this was BSON_APPEND_BOOL(3), version 2.5.6, dated Oct 09, 2026 — write it down, remember it, slay 💅✨🎀

📦 where this page comes from