BSON_APPEND_INT32(3)

💅 BSON_APPEND_INT32 💅

ok so this is a page from the libbson manual, bestie — it's all about bson_append_int32, the little guy that shoves a 32-bit signed integer into your BSON document. it's giving "small but iconic" fr fr. let's get into it 🫶

---

✨ SYNOPSIS ✨

here's the vibe, literally two ways in — a macro and the real function:

#define BSON_APPEND_INT32(b, key, val) \
   bson_append_int32 (b, key, (int) strlen (key), val)

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

the macro is the shortcut bestie — it does the strlen() for you so you don't have to. the function underneath is where the actual work happens. 💖

---

🌸 PARAMETERS 🌸

• bson — a bson_t. that's your document, the main character of this whole operation 👑
• key — an ASCII C string with the name of the field. the label on the box, basically ✨
• key_length — how long key is, in bytes. or pass -1 and it'll figure it out with strlen() for you, no cap 🙈
• value — an int32_t. the actual number going in 🍓

---

🦋 DESCRIPTION 🦋

bson_append_int32() appends a brand new element to bson, and that element holds a 32-bit signed integer. that's it. that's the whole job. it ate, honestly 💅

---

⭐ RETURNS ⭐

returns true if the operation went through successfully. slay. 🔥

but heads up — the function will fail if appending value grows bson past INT32_MAX. that's the limit, bestie, don't push it 😭

ngl, that's the one thing to keep in mind: if your document balloons beyond INT32_MAX while you're appending, the call fails and you get false. plan accordingly 🧚

---

💜 AUTHOR 💜

MongoDB, Inc — the icons behind all this ✨

🌈 COPYRIGHT 🌈

2009-present, MongoDB, Inc.

---

that's the whole page, no skips, no summarising, we read the entire thing 💀💖

and for the cute sign-off: this was version 2.5.6 of the libbson manual, dated Oct 09, 2026 — screenshot it, screenshot it 🎀🦋⭐