boost::urls::params_encoded_ref::replace

Replace params

Synopsis

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

template<class FwdIt>
iterator
replace(
    iterator from,
    iterator to,
    FwdIt first,
    FwdIt last);

Description

This function replaces a range of params with a range of params.

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. 
std::is_convertible< std::iterator_traits< FwdIt >::reference_type, param_pct_view >::value == true

Linear in `this‐>url().encoded_query().size()`.

Strong guarantee.

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

Exceptions

Name Thrown on

The

range contains an invalid percent&hyphen;encoding&period;

Return Value

An iterator to the first element inserted, or one past `to` if `first == last`.

Parameters

Name Description

from,to

The range of params to replace&period;

first,

last The range of params to assign&period;

Created with MrDocs