Find a matching key
Synopsis
Declared in header <boost/url/params_encoded_base.hpp>
iterator
find_last(
pct_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, which may contain percent escapes. The comparison is performed as if all escaped characters were decoded first.
The search starts from the last param
and proceeds backwards until either the
key is found or the beginning of the
range is reached, in which case end()
is returned.
Example
assert( url_view( "?first=John&last=Doe" ).encoded_params().find_last( "last" )->value == "Doe" );
Complexity
Linear in this->buffer().size()
.
Exception Safety
Exceptions thrown on invalid input.
Exceptions
Name | Thrown on |
---|---|
|
|
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. |