boost::urls::url::set_encoded

Set the query params

Synopsis

url&
set_encoded_params(std::initializer_list<param_pct_view> ps);

This sets the query params to the elements in the list, which may contain percent‐escapes and can be empty.

An empty list of params is distinct from having no query.

Escapes in the string are preserved, and reserved characters in the string are percent‐escaped in the result.

assert( url( "http://example.com" ).set_encoded_params( {"id", "42"} ).encoded_query() == "id=42" );

this->has_query() == true

Linear.

Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input.

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

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

*this

Name

Description

The params to set.