BSON_SIZED_NEW(3)

✨ BSON_SIZED_NEW(3) ✨

okay bestie, so this is a page out of libbson and honestly it's short and sweet, we love a low-effort icon 💅

---

🌸 SYNOPSIS 🌸

bson_t *
bson_sized_new (size_t size);

like, that's it. that's the whole vibe. 🎀

---

🦋 PARAMETERS 🦋

• size — the size you want pre-allocated for the underlying buffer. yes, that's the whole parameter. she's simple, she's direct, we stan 💖

---

🧚 DESCRIPTION 🧚

so the way that bson_sized_new() works is: it creates a new bson_t on the heap, and that bson_t comes with a preallocated buffer already set up for you ✨ no cap.

and like, when is this useful? when you actually have a good idea of how big your resulting document is gonna be 👀 then you tell it up front and it's giving prepared, it's giving organized, it's giving main character energy 👑

tl;dr: you know the size, so you say the size, and the buffer is already waiting for you 🫶

---

🔥 RETURNS 🔥

a freshly allocated bson_t 🎉 — and bestie, listen to me, you must free it with bson_destroy(). don't just leave her hanging, that's so not slay 😭 memory leaks are NOT the vibe.

---

🌈 AUTHOR 🌈

MongoDB, Inc — the icons themselves 👑

---

⭐ COPYRIGHT ⭐

2009-present, MongoDB, Inc. — periodt, protected 💜

---

okay that's the whole page, you're basically an expert now 🦋 this little number is from version 2.5.6, dated Oct 09, 2026 — mwah, go forth and allocate responsibly 💅🎀