boost::urls::params_encoded_ref::replace

Replace params

Synopsis

Declared in <boost/url/params_encoded_ref.hpp>

iterator
replace(
    iterator from,
    iterator to,
    std::initializer_list<param_pct_view> init);

This function replaces a range of params with the params in an initializer-list.

All iterators that are equal to from or come after are invalidated.

The strings referenced by the inputs must not come from the underlying url, or else the behavior is undefined.

Linear in this->url().encoded_query().size().

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

Name	Thrown on
`system_error`	`init` contains an invalid percent-encoding.

An iterator to the first element inserted, or one past to if init.size() == 0.

Name	Description
from,to	The range of params to replace.
init	The list of params to assign.