Function params_ref::replace

Replace elements

Synopsis

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

params_base::iterator
replace(
    params_base::iterator pos,
    const param_view& 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

Name Description

pos

An iterator to the element.

p

The param to assign.