find

Find a matching key

Synopsis

iterator
find(
    iterator from,
    pct_string_view key,
    ignore_case_param ic = = {}) const noexcept;

Declared in file <include/boost/url/params_encoded_base.hpp> on line 408

Defined in file <include/boost/url/impl/params_encoded_base.hpp> on line 145

Description

This function examines the parameters in the container to find a match for the specified key, which may contain percent escapes. 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.

Example

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

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

Complexity

Linear in this->buffer().size().

Exception Safety

Exceptions thrown on invalid input.