# bson_iter_dup_utf8()

## Synopsis

    char *
    bson_iter_dup_utf8 (const bson_iter_t *iter,
                        uint32_t          *length);

## Parameters

iter | A bson_iter_t.
length | An optional location for the length of the UTF-8 encoded string.

## Description

This function is similar to bson_iter_utf8() except that it calls bson_strndup() on the result.

## Returns

A newly allocated string that should be freed with bson_free().