BSON_ARRAY_ALLOC(3)

💅 BSON_ARRAY_ALLOC(3) — the libbson glow-up

okay bestie, so this is a libbson page, and it's genuinely one of the shortest and sweetest ones — it's literally just "we made malloc() portable and also it will Not hesitate to end your whole process" 🫶 so let's get into it ✨

---

✨ SYNOPSIS ✨

#define BSON_ARRAY_ALLOC(Count, Type) \
   (Type*) bson_array_alloc (Count, sizeof (Type))

void *
bson_array_alloc (size_t num_elems, size_t elem_size);

so there's the macro (she's giving convenience 💅) and there's the actual function underneath her. two icons, one vibe 💖

---

🎀 PARAMETERS 🎀

• num_elems — a size_t holding the number of objects to allocate. like, how many of the thing do you want. that many 🌸
• elem_size — a size_t holding the size of each object in bytes. how chunky is each one 📏

---

💖 DESCRIPTION 💖

this is a portable malloc() wrapper that allocates an array of objects. that's the whole pitch, and honestly? she ate. ✨

now here's the part where you sit up straight, because: if num_elems * elem_size cannot be represented in a size_t, or if there was a failure to allocate num_elems * elem_size bytes, the process will be aborted. 😭 like, not "return NULL and let you handle it" — the process is done. main character exit, no encore 💀

⚠️ WARNING: this function will abort on failure to allocate memory. no cap, no graceful degradation, just vibes and termination. plan accordingly bestie 🙈

---

⭐ RETURNS ⭐

a pointer to a memory region which HAS NOT been zeroed. read that again. HAS NOT. it's not clean, it's not fresh, it's not a blank slate — if you want zeroes you're gonna have to put them there yourself 🧚

lowkey this is the classic malloc behaviour, she's just being very clear about it so nobody comes for her later 💅

---

👑 AUTHOR 👑

MongoDB, Inc

🌈 COPYRIGHT 🌈

2009-present, MongoDB, Inc.

---

so yeah, that's the whole page, short and iconic 🦋 libbson version 2.5.6, dated Oct 09, 2026 — mwah, that's the sign-off, go forth and allocate responsibly and maybe check your multiplication first bestie 🍓💜