bson_append_binary()

Synopsis

bool
bson_append_binary (bson_t        *bson,
                    const char    *key,
                    int            key_length,
                    bson_subtype_t subtype,
                    const uint8_t *binary,
                    uint32_t       length);

Parameters

bson	A bson_t.
key	The key name.
key_length	The length of key in bytes or -1 to use strlen().
subtype	A bson_subtype_t indicationg the binary subtype.
binary	A buffer to embed as binary data.
length	The length of buffer in bytes.

Description

The bson_append_binary() function shall append a new element to bson containing the binary data provided.

Returns

true if the operation was applied successfully, otherwise false and bson should be discarded.