NAME¶
bson_append_document() - The bson_append_document() function shall append child
to bson using the specified key. The type of the field will be a document.
SYNOPSIS¶
bool
bson_append_document (bson_t *bson,
const char *key,
int key_length,
const bson_t *value);
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)
- value
- A bson_t containing the sub‐document to append.
DESCRIPTION¶
The bson_append_document(3) function shall append child to
bson using the specified key. The type of the field will be a document.
RETURNS¶
true if the operation was applied successfully, otherwise false and bson
should be discarded.