SYNOPSIS

#include <bson.h>

#define BSON_ITER_HOLDS_DOCUMENT(iter) \
   (bson_iter_type ((iter)) == BSON_TYPE_DOCUMENT)

void
bson_iter_document (const bson_iter_t *iter,
                    uint32_t          *document_len,
                    const uint8_t    **document);

DESCRIPTION

The bson_iter_document() function shall retrieve the raw buffer of a sub-document from iter. iter MUST be on an element that is of type BSON_TYPE_DOCUMENT. This can be verified with bson_iter_type() or the BSON_ITER_HOLDS_DOCUMENT() macro.

ERRORS

It is a programming error to call this function on an element that is not of BSON_TYPE_DOCUMENT.

SEE ALSO

AUTHORS

This page was written by MongoDB, Inc.