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