DOKK / manpages / debian 12 / libbson-doc / bson_append_undefined.3.en
BSON_APPEND_UNDEFINED(3) libbson BSON_APPEND_UNDEFINED(3)

bson_append_undefined - bson_append_undefined()

#define BSON_APPEND_UNDEFINED(b, key) \


   bson_append_undefined (b, key, (int) strlen (key))
bool
bson_append_undefined (bson_t *bson, const char *key, int key_length);


  • bson: A bson_t.
  • 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().

The bson_append_undefined() function shall append a new element to bson of type BSON_TYPE_UNDEFINED. Undefined is common in Javascript. However, this element type is deprecated and should not be used in new code.

Returns true if the operation was applied successfully. The function will fail if appending the value grows bson larger than INT32_MAX.

MongoDB, Inc

2017-present, MongoDB, Inc

October 20, 2022 1.23.1