BSON_APPEND_ARRAY_BEGIN(3)

💅 BSON_APPEND_ARRAY_BEGIN(3) 💅

okay bestie, this is the libbson page for BSON_APPEND_ARRAY_BEGIN(3) — yes, the manual name is libbson, she’s iconic, and this one comes with a big deprecation warning. 🚨

---

🚨 WARNING 🚨

Deprecated since version 2.3.0: use bson_append_array_builder_begin to safely generate array keys ("0", "1", "2", ...) or bson_append_array_unsafe_begin() to manually provide keys.

like, for real, do not start new code with this one, periodt. 💀

---

✨ SYNOPSIS ✨

#define BSON_APPEND_ARRAY_BEGIN(b, key, child) \
   bson_append_array_begin (b, key, (int) strlen (key), child)

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

---

🦋 DESCRIPTION 🦋

okay so real talk: this function is a deprecated alias of bson_append_array_unsafe_begin(). that’s the whole vibe. no cap. 💀

Consider using bson_array_builder_t to append an array without needing to generate array element keys. that’s the glow-up path, bestie ✨

👀 SEE ALSO 👀

• bson_array_builder_t
• bson_append_array_unsafe_begin()

---

👑 AUTHOR 👑

MongoDB, Inc

---

🎀 COPYRIGHT 🎀

2009-present, MongoDB, Inc.

---

mwah 💖 this page is from libbson version 2.5.6, dated Oct 09, 2026 — stay hydrated and go use the non-deprecated one, bestie 🫶🌈