BSON_APPEND_VECTOR_INT8_UNINIT(3)

📦
version 2.5.6 · 3 versions
, in epel 10

🦋 bestie's guide to BSON_APPEND_VECTOR_INT8_UNINIT 🦋

okay so this is the libbson manual page for BSON_APPEND_VECTOR_INT8_UNINIT(3) — and it's literally about appending a Vector of int8 elements while leaving them uninitialized. yes, uninitialized. we love a little responsibility. 💅✨

✨ SYNOPSIS ✨

          #define BSON_APPEND_VECTOR_INT8_UNINIT(b, key, count, view) \
             bson_append_vector_int8_uninit (b, key, (int) strlen (key), count, view)

          bool
          bson_append_vector_int8_uninit (bson_t *bson,
                                          const char *key,
                                          int key_length,
                                          size_t element_count,
                                          bson_vector_int8_view_t *view_out);

🎀 PARAMETERS 🎀

  • bson — a bson_t. that's the document bestie, the whole vibe. 🫶
  • key — an ASCII C string containing the name of the field. name it cute, name it clear. 💖
  • key_length — the length of key in bytes, or -1 to determine the length with strlen(). shortcut slay. ✨
  • element_count — number of elements to allocate space for. count 'em. 🔢
  • view_out — receives a bson_vector_int8_view_t with uninitialized elements. it's giving empty canvas energy. 🎨

💖 DESCRIPTION 💖

so this function appends a new field to bson by allocating a Vector with the indicated number of int8 elements. the elements will be uninitialized. no defaults, no little starter values, just space. 🙈

⚠️ on success, the caller must write every element in the Vector if the resulting bson_t is to be used. every single one. no skipping. that's the assignment. 💀

the view written to *view_out is only valid until bson is otherwise modified or freed. so yeah, that pointer is not forever — once bson gets modified or freed, it's done. 😭

🔥 RETURNS 🔥

returns true if the operation was applied successfully. 🎉

the function fails if appending the array grows bson larger than INT32_MAX. that's the limit, bestie. no cap. 🚫

👑 AUTHOR 👑

MongoDB, Inc

2009-present, MongoDB, Inc.

xoxo, your libbson bestie 💖 — this page is version 2.5.6, dated Oct 09, 2026. slay and read the docs responsibly. 🎀✨

📦 where this page comes from