SYNOPSIS

          bool
          bson_iter_init_from_data_at_offset (bson_iter_t *iter,
                                              const uint8_t *data,
                                              size_t length,
                                              uint32_t offset,
                                              uint32_t keylen);

PARAMETERS

       • iter: A bson_iter_t <>.

       • data: A buffer to initialize with. This is not validated.

       • length: The length of data in bytes. This is not validated.

       • offset:  The  offset  of  the field to start iterating. This is not validated. This should be an offset
         previously obtained from bson_iter_offset() <>.

       • keylen: The string length of the key of the field to start  iterating.  This  is  not  validated.  This
         should be a length previously obtained from bson_iter_key_len() <>.

DESCRIPTION

       Creates a bson_iter_t <> and starts iteration on a field at the offset.

       bson_iter_init_from_data_at_offset()  <>  is useful for situations where the progress of a bson_iter_t <>
       must be saved and restored without relying on the bson_iter_t <> data layout. Saving the  progress  could
       be accomplished by:

       • Saving the current field's key length with bson_iter_key_len() <>

       • Saving the current offset with bson_iter_offset() <>

       • Saving the data pointer of the iterated bson_t <> with bson_get_data() <>

       • Saving the data length of the iterated bson_t <> with the len struct field

       Then  later,  these  saved values can be passed to bson_iter_init_from_data_at_offset() <> to reconstruct
       the bson_iter_t <> in constant time.

RETURNS

       Returns true if the iter was successfully initialized.

       See also:
          bson_iter_key_len() <>

          bson_iter_offset() <>

          bson_get_data() <>

Author

       MongoDB, Inc

Copyright

       2009-present, MongoDB, Inc.

2.2.1                                             Dec 11, 2025             BSON_ITER_INIT_FROM_DATA_AT_OFFSET(3)