boost::urls::url_view_base::query

Return the query

Synopsis

Declared in <boost/url/url_view_base.hpp>

template<string_token::StringToken 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.

Literal plus signs remain unchanged by default to match RFC 3986. To treat '+' as a space, supply decoding options with space_as_plus = true when calling this function.

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

Return Value

The query as a string.

Parameters

Name Description

token

A token to use for the returned string.

See Also

encoded_params, encoded_query, has_query, params.

Created with MrDocs