bson_append_code()

Synopsis

#define BSON_APPEND_CODE(b, key, val) \
   bson_append_code (b, key, (int) strlen (key), val)

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

Parameters

  • bson: A bson_t.

  • key: The key name.

  • key_length: The length of key or -1 to use strlen().

  • javascript: A UTF-8 encoded string containing the javascript.

Description

The bson_append_code() function shall append a new element to bson using the UTF-8 encoded javascript provided. javascript must be a NULL terminated C string.

Returns

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