# bson_iter_find_w_len()

## Synopsis

    bool
    bson_iter_find_w_len (bson_iter_t *iter, const char *key, int keylen);

## Parameters

- `iter`: A bson_iter_t.

- `key`: A string containing the requested key.

- `keylen`: An integer indicating the length of the key string.

## Description

The `bson_iter_find_w_len()` function shall advance `iter` to the element named `key` or exhaust all elements of `iter`. If `iter` is exhausted, false is returned and `iter` should be considered invalid.

`key` is case-sensitive. For a case-folded version, see bson_iter_find_case().

## Returns

true is returned if the requested key was found. If not, `iter` was exhausted and should now be considered invalid.