BSON_VALUE_COPY(3)

📦
version 2.5.6 · 16 versions
, in epel 10

💖 BSON_VALUE_COPY(3) 💖

okay bestie, welcome to the libbson page for bson_value_copy() — the little function that’s all about copying the boxed value content without leaking memory. it’s giving “simple but you MUST read the fine print” energy, fr fr. 💅

✨ SYNOPSIS ✨

void
bson_value_copy (const bson_value_t *src, bson_value_t *dst);

🎀 PARAMETERS 🎀

  • src — a bson_value_t to copy from. the source, the original, the main character 👑
  • dst — a bson_value_t to copy into. the destination, the copy era 🦋

🦋 DESCRIPTION 🦋

okay so this function will copy the boxed content in src into dst. yes bestie, it’s a copy-copy situation. 💖

dst must be freed with bson_value_destroy() when no longer in use. that’s the cleanup step, don’t skip it. 🧚

and this is the important part: dst MUST be an uninitialized bson_value_t to avoid leaking memory. like, MUST MUST. not “eh, maybe.” no cap. 😭

NOTE: if src represents a BSON UTF-8 string, bson_value_copy() attempts to NULL terminate the copied string in dst. if src.value.v_utf8.len is SIZE_MAX, the copied string is (necessarily) not NULL terminated. so yeah, that’s the vibe check on that one 💀

👑 AUTHOR 👑

MongoDB, Inc — iconic, honestly. 🫶

2009-present, MongoDB, Inc. — periodt, protect the copyright bestie 💜

xoxo, your libbson bestie 🌸 — this is version 2.5.6, dated Oct 09, 2026. bye bestie, go copy safely and don’t leak! 💅✨

📦 where this page comes from