BSON_APPEND_NULL(3)

📦
version 2.5.6 · 16 versions
, in epel 10

okay so this is the BSON_APPEND_NULL(3) page from libbson, and it's giving “append a null element” realness 💖 let's get into it, bestie.

✨ SYNOPSIS ✨

like literally, here's the exact synopsis:

#define BSON_APPEND_NULL(b, key) bson_append_null (b, key, (int) strlen (key))

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

🎀 PARAMETERS 🎀

  • bson — A bson_t. the doc you're blessing with a new field.
  • key — An ASCII C string containing the name of the field.
  • key_length — The length of key in bytes, or -1 to determine the length with strlen().

🦋 DESCRIPTION 🦋

The bson_append_null() function shall append a new element to bson of type BSON_TYPE_NULL. that's it, that's the whole serve 💅

🌸 RETURNS 🌸

Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX. so if your BSON grows past INT32_MAX, it's a no-go, bestie 😭

👑 AUTHOR 👑

MongoDB, Inc

2009-present, MongoDB, Inc.

cute sign-off time 🫶 this BSON_APPEND_NULL(3) page is from libbson version 2.5.6, dated Oct 09, 2026. go forth and append nulls, icon 💖✨

📦 where this page comes from