BSON_STRING_APPEND_UNICHAR(3)

💖 BSON_STRING_APPEND_UNICHAR 💖

okay bestie, welcome to the libbson manual, section 3, and today's main character is bson_string_append_unichar. yes the name is a mouthful. no you don't have to say it out loud. 🫶

⚠️ WARNING: Deprecated since version 1.29.0. she's retired, babes. still documented, still here, but the clock is ticking. 💀

---

✨ SYNOPSIS ✨

void
bson_string_append_unichar (bson_string_t *string, bson_unichar_t unichar);

like, that's it. that's the whole vibe. void return, two args, no drama. 💅

---

🎀 PARAMETERS 🎀

• string — a bson_string_t. the string you're appending to, the canvas, the moment. 🌸
• unichar — a bson_unichar_t. the unicode character you're yeeting in there. ✨

---

🦋 DESCRIPTION 🦋

so what she does: she appends a unicode character to string. and the way that she does it is iconic — the character gets encoded into its multi-byte UTF-8 representation. like, one unicode char goes in, and it comes out as however many bytes UTF-8 decides it needs. slay. 🔥

⚠️ WARNING: the length of the resulting string (including the NULL terminator) MUST NOT exceed UINT32_MAX. not "shouldn't", not "try not to". MUST NOT. fr fr. if you blow past that limit you're on your own and the vibes will be immaculate but catastrophic. 😭

---

👑 AUTHOR 👑

MongoDB, Inc — the icon, the legend, the moment. 💜

---

🌈 COPYRIGHT 🌈

2009-present, MongoDB, Inc. — all rights reserved, all vibes preserved. ⭐

---

and that's the whole page bestie, no cap. this was libbson version 1.30.13, dated Oct 09, 2026, and it's giving "read the deprecation warning" energy. go forth and encode responsibly. 🧚💖🎀