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.

COLOPHON

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

libbson                                            2016‐01‐18                            BSON_APPEND_DOCUMENT(3)