boost::urls::params_base::find

Find a matching key

Synopsis

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

iterator
find(
    iterator from,
    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 at `from` and proceeds forward until either the key is found or the end of the range is reached, in which case `end()` is returned.

url_view u( "?First=John&Last=Doe" );

assert( u.params().find( "first" ) != u.params().find( "first", ignore_case ) );

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

Return Value

an iterator to the param

Parameters

Name	Description
from	The position to begin the search from&period; This can be &grave;end()&grave;&period;
key	The key to match&period; By default, a case&hyphen;sensitive comparison is used&period;
ic	An optional parameter&period; If the value xref:boost/urls/ignore_case.adoc[ignore&lowbar;case] is passed here, the comparison is case&hyphen;insensitive&period;

Name

Description

from

The position to begin the search from&period; This can be &grave;end()&grave;&period;

key

The key to match&period; By default, a case&hyphen;sensitive comparison is used&period;

An optional parameter&period; If the value xref:boost/urls/ignore_case.adoc[ignore&lowbar;case] is passed here, the comparison is case&hyphen;insensitive&period;

Created with MrDocs