boost::urls::params_ref::replace

Replace elements

Synopsis

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


iterator
replace(
    iterator pos,
    param_view const& p);


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


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

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.


url u( "?first=John&last=Doe" );

u.params().replace( u.params().begin(), { "title", "Mr" });

assert( u.encoded_query() == "title=Mr&last=Doe" );

Calls to allocate may throw.

An iterator to the element.

Name	Description
pos	An iterator to the element.
p	The param to assign.
from,to	The range of elements to replace.
init	The list of params to assign.
first,	last The range of params to assign.