replace

Replace params

Synopsis


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

Declared in file <src/params_encoded_ref.cpp> at line 139

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.

NOTE

The strings passed in must not come from the element being replaced, or else the behavior is undefined.

Example


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

u.encoded_params().replace( u.encoded_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. Exceptions thrown on invalid input.