![]() |
Home | Libraries | People | FAQ | More |
Set the query params.
url_base& 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( [link url.ref.boost__urls__url_base.url `url`]( "http://example.com" ).[link url.ref.boost__urls__url_base.set_encoded_params `set_encoded_params`]( { "id" , "42" } ).[link url.ref.boost__urls__url_base.encoded_query `encoded_query`]() == "id=42" );
this->[link url.ref.boost__urls__url_base.has_query `has_query`]() == true
Linear.
Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input.
Name |
Description |
---|---|
|
The params to set. |
Type |
Thrown On |
---|---|
|
some element in |
[link url.ref.boost__urls__url_base.query `query`] = *( pchar / "/" / "?" ) [link url.ref.boost__urls__url_base.query `query`]-param = key [ "=" value ] [link url.ref.boost__urls__url_base.query `query`]-[link url.ref.boost__urls__url_base.params `params`] = [ [link url.ref.boost__urls__url_base.query `query`]-param ] *( "&" [link url.ref.boost__urls__url_base.query `query`]-param )
set_params
, params
, remove_query
, set_encoded_query
, set_query
.