Replace elements

Synopsis

Declared in header </boost/url/params_ref.hpp#L691[boost/url/params_ref.hpp,window=blank_]>

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

  • iterator

Parameters

Name Type

pos

iterator

p

``