Skip to content
Back to top

# 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.