Scroll to navigation

BSON_ITER_BINARY(3) libbson BSON_ITER_BINARY(3)

NAME

bson_iter_binary - bson_iter_binary()

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().

The buffer that binary points to is only valid until the iterator's bson_t is modified or freed.

AUTHOR

MongoDB, Inc

COPYRIGHT

2017-present, MongoDB, Inc

August 31, 2022 1.23.0