Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the master branch, built from commit a8a4da0b3c.
PrevUpHomeNext
params_encoded_ref::count

(Inherited from params_encoded_base)

Return the number of matching keys.

Synopsis
std::size_t
count(
    pct_string_view key,
    ignore_case_param ic = {}) const;
Description

This function examines the parameters in the container to find the number of matches for the specified key, which may contain percent escapes. The comparison is performed as if all escaped characters were decoded first.

Example
assert( url_view( "?first=John&last=Doe" ).encoded_params().count( "first" ) == 1 );
Complexity

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

Exception Safety

Exceptions thrown on invalid input.

Exceptions

Type

Thrown On

system_error

key contains an invalid percent-encoding.

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.


PrevUpHomeNext