# bson_iter_codewscope()

## Synopsis

    #define BSON_ITER_HOLDS_CODEWSCOPE(iter) \
       (bson_iter_type ((iter)) == BSON_TYPE_CODEWSCOPE)

    const char *
    bson_iter_codewscope (const bson_iter_t *iter,
                          uint32_t          *length,
                          uint32_t          *scope_len,
                          const uint8_t    **scope);

## Parameters

iter | A bson_iter_t.
length | An optional location for the length of the resulting UTF-8 encoded string.
scope_len | A optional location for the length of scope.
scope | An optional location to store the immutable raw scope BSON document.

## Description

The bson_iter_codewscope() function acts similar to bson_iter_code() except for BSON_TYPE_CODEWSCOPE elements. It also will provide a pointer to the buffer for scope, which can be loaded into a bson_t using bson_init_static().

## Returns

An UTF-8 encoded string containing the JavaScript code which should not be modified or freed.