SYNOPSIS

          bool
          bson_append_iter (bson_t *bson,
                            const char *key,
                            int key_length,
                            const bson_iter_t *iter);

PARAMETERS

       • bson: A bson_t <>.

       • key: Optional field name. If NULL, uses bson_iter_key(iter) <>.

       • key_length: The length of key or -1 to use strlen().

       • iter: A bson_iter_t <> located on the position of the element to append.

DESCRIPTION

       Appends the value at the current position of iter to the document.

RETURNS

       Returns  true  if  successful; false if the operation would overflow the maximum document size or another
       invalid state is detected.

Author

       MongoDB, Inc

Copyright

       2009-present, MongoDB, Inc.

2.2.1                                             Dec 11, 2025                               BSON_APPEND_ITER(3)