boost::urls::params_encoded_ref::replace

Replace params

Synopsis

Declared in <include/boost/url/params_encoded_ref.hpp>

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

Description

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.

NOTE

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.

Exceptions

Name Thrown on
`init`

contains an invalid percent-encoding.

Return Value

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

Parameters

Name Description
from,to

The range of params to replace.

init

The list of params to assign.

Created with MrDocs