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 an old version of Boost. Click here to view this page for the latest version.
PrevUpHomeNext
url_base::query

(Inherited from url_view_base)

Return the query.

Synopsis
template<
    class StringToken = string_token::return_string>
StringToken::result_type
query(
    StringToken&& token = {}) const;
Description

If this contains a query, it is returned as a string (which may be empty). Otherwise, an empty string is returned. Any percent-escapes in the string are decoded first.

When plus signs appear in the query portion of the url, they are converted to spaces automatically upon decoding. This behavior can be changed by setting decode options.

Example
assert( url_view( "/sql?id=42&name=jane%2Ddoe&page+size=20" ).query() == "id=42&name=jane-doe&page size=20" );
Complexity

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

Exception Safety

Calls to allocate may throw.

BNF
query           = *( pchar / "/" / "?" )

query-param     = key [ "=" value ]
query-params    = [ query-param ] *( "&" query-param )
Specification
See Also

encoded_params, encoded_query, has_query, params.


PrevUpHomeNext