Set a value

Synopsis

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

params_base::iterator
set(
    params_base::iterator pos,
    string_view value);

Description

This function replaces the value of an element at the specified position. All iterators that are equal to pos or come after are invalidated.

Example

url u( "?id=42&id=69" );

u.params().set( u.params().begin(), "none" );

assert( u.encoded_query() == "id=none&id=69" );

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

value

string_view