NAME¶
bson_iter_binary() - This function shall return the binary data of a
BSON_TYPE_BINARY element. It is a programming error to call this function on a
field that is not of type BSON_TYPE_BINARY. You can check this with the
BSON_ITER_HOLDS_BINARY() macro or bson_iter_type().
SYNOPSIS¶
#define BSON_ITER_HOLDS_BINARY(iter) \
(bson_iter_type ((iter)) == BSON_TYPE_BINARY)
void
bson_iter_binary (const bson_iter_t *iter,
bson_subtype_t *subtype,
uint32_t *binary_len,
const uint8_t **binary);
PARAMETERS¶
- iter
- A bson_iter_t
- subtype
- A location for a bson_subtype_t or NULL.
- binary_len
- A location for the length of binary
- binary
- A location for a pointer to the immutable buffer.
DESCRIPTION¶
This function shall return the binary data of a BSON_TYPE_BINARY element. It is
a programming error to call this function on a field that is not of type
BSON_TYPE_BINARY. You can check this with the BSON_ITER_HOLDS_BINARY() macro
or bson_iter_type(3)
The buffer that binary points to is only valid until the
iterator's bson_t is modified or freed.