1BSON_APPEND_DOCUMENT(3)             libbson            BSON_APPEND_DOCUMENT(3)
2
3
4

NAME

6       bson_append_document - bson_append_document()
7

SYNOPSIS

9          #define BSON_APPEND_DOCUMENT(b, key, val) \
10             bson_append_document (b, key, (int) strlen (key), val)
11
12          bool
13          bson_append_document (bson_t *bson,
14                                const char *key,
15                                int key_length,
16                                const bson_t *value);
17

PARAMETERS

19       • bson: A bson_t.
20
21       • key: An ASCII C string containing the name of the field.
22
23       • key_length: The length of key in bytes, or -1 to determine the length
24         with strlen().
25
26       • value: A bson_t containing the sub-document to append.
27

DESCRIPTION

29       The bson_append_document() function shall append child  to  bson  using
30       the specified key. The type of the field will be a document.
31

RETURNS

33       Returns  true  if  the operation was applied successfully. The function
34       will fail if appending value grows bson larger than INT32_MAX.
35

AUTHOR

37       MongoDB, Inc
38

40       2017-present, MongoDB, Inc
41
42
43
44
451.23.1                           Oct 20, 2022          BSON_APPEND_DOCUMENT(3)
Impressum