NAME¶
bson_append_array_begin() - The bson_append_array_begin() function shall begin
appending an array field to bson. This allows for incrementally building a
sub-array. Doing so will generally yield better performance as you will
serialize to a single buffer. When done building the sub-array, the caller
MUST call bson_append_array_end().
SYNOPSIS¶
bool
bson_append_array_begin (bson_t *bson,
const char *key,
int key_length,
bson_t *child);
PARAMETERS¶
- bson
- A bson_t
- key
- A string containing the name for the key.
- key_length
- The length of key or ‐1 to call strlen(3)
- child
- A bson_t
RETURNS¶
true if the operation was applied successfully, otherwise false and bson
should be discarded.