Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Back to top
Toggle table of contents sidebar

# 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.