boost::urls::params_encoded_ref::replace
Replace params
Synopsis
Declared in <boost/url/params_encoded_ref.hpp>
iterator
replace(
iterator pos,
param_pct_view const& p);
iterator
replace(
iterator from,
iterator to,
std::initializer_list<param_pct_view> init);
Description
This function replaces the contents
of the element at pos with the
specified param.
All iterators that are equal to
pos or come after are invalidated.
| The strings passed in must not come from the element being replaced, or else the behavior is undefined. |
url u( "?first=John&last=Doe" );
u.encoded_params().replace( u.encoded_params().begin(), { "title", "Mr" });
assert( u.encoded_query() == "title=Mr&last=Doe" );
Exceptions
| Name | Thrown on |
|---|---|
|
contains an invalid percent-encoding. |
|
contains an invalid percent-encoding. |
|
range contains an invalid percent-encoding. |
Parameters
| Name | Description |
|---|---|
pos |
An iterator to the element. |
p |
The param to assign. |
from,to |
The range of params to replace. |
init |
The list of params to assign. |
first, |
last The range of params to assign. |
Created with MrDocs