Set a value
<include/boost/url/params_encoded_ref.hpp>
iterator
set(
pct_string_view key,
pct_string_view value,
ignore_case_param ic = = {});
This function performs one of two actions depending on the value of `this->contains( key, ic )`.
All iterators are invalidated.
The strings passed in must not come from the element being replaced, or else the behavior is undefined.
url u( "?id=42&id=69" );
u.encoded_params().set( "id", "none" );
assert( u.encoded_params().count( "id" ) == 1 );
this->count( key, ic ) == 1 && this->find( key, ic )->value == value
Calls to allocate may throw. Exceptions thrown on invalid input.
Name | Thrown on |
---|---|
`key` |
or `value` contain an invalid percent-encoding. |
An iterator to the appended or modified element.
Name | Description |
---|---|
key | The key to match. By default, a case-sensitive comparison is used. |
value | The value to assign. The empty string still counts as a value. That is, `has_value` for the element is true. |
ic | An optional parameter. If the value ignore_case is passed here, the comparison is case-insensitive. |