boost::urls::params_ref::replace

Replace elements

Synopsis

Declared in <boost/url/params_ref.hpp>

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

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.

Example


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

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

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

Complexity

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

Exception Safety

Strong guarantee. Calls to allocate may throw.

Return Value

An iterator to the element.

Parameters

NameDescription
posAn iterator to the element.
pThe param to assign.