boost::urls::params_base::find :: Boost Libraries Documentation

# boost::urls::params_base::find

Find a matching key

## Synopsis

Declared in `<boost/url/params_base.hpp>`

    iterator
    find(
        core::string_view key,
        ignore_case_param ic = {}) const noexcept;

## Description

This function examines the parameters in the container to find a match for the specified key. The comparison is performed as if all escaped characters were decoded first.

The search starts from the first param and proceeds forward until either the key is found or the end of the range is reached, in which case `end()` is returned.

## Example

    assert( (*url_view( "?first=John&last=Doe" ).params().find( "First", ignore_case )).value == "John" );

## Effects

    return this->find( this->begin(), key, ic );

## Complexity

Linear in `this‐>buffer().size()`.

## Return Value

an iterator to the param

## Parameters

Name | Description
--- | ---
key | The key to match. By default, a case‐sensitive comparison is used.
ic | An optional parameter. If the value `ignore_case` is passed here, the comparison is case‐insensitive.

Created with MrDocs