Scroll to navigation

BSON_APPEND_ARRAY(3) Library Functions Manual BSON_APPEND_ARRAY(3)

NAME

bson_append_array() - The bson_append_array() function shall append child to bson using the specified key. The type of the field will be an array, but it is the responsibility of the caller to ensure that the keys of child are properly formatted with string keys such as "0", "1", "2" and so forth.

SYNOPSIS


bool bson_append_array (bson_t *bson, const char *key, int key_length, const bson_t *array);

PARAMETERS

bson
A bson_t
key
An ASCII C string containing the name of the field.
key_length
The length of key in bytes, or ‐1 to determine the length with strlen(3)
array
A bson_t

DESCRIPTION

The bson_append_array(3) function shall append child to bson using the specified key. The type of the field will be an array, but it is the responsibility of the caller to ensure that the keys of child are properly formatted with string keys such as "0", "1", "2" and so forth.

RETURNS

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

COLOPHON

This page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.
2016‐10‐12 libbson