Set a value

Synopsis

iterator
set(
    core::string_view key,
    core::string_view value,
    ignore_case_param ic = {});

Description

This function performs one of two actions depending on the value of this->contains( key, ic ).

• If key is contained in the view then one of the matching elements has its value changed to the specified value. The remaining elements with a matching key are erased. Otherwise,

• If `key` is not contained in the view, then the function apppends the param `{ key, value }`.

All iterators are invalidated.

Example

url u( "?id=42&id=69" ); u.params().set( "id", "none" ); assert( u.params().count( "id" ) == 1 );

Postconditions

this->count( key, ic ) == 1 && this->find( key, ic )->value == value

Complexity

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

Exception Safety

Strong guarantee. Calls to allocate may throw.

Return Value

An iterator to the appended or modified element.

Parameters

Name	Description
key	The key to match. By default, a case-sensitive comparison is used.
value	The value to assign. The empty string still counts as a value. That is, has_value for the element is true.
ic	An optional parameter. If the value ignore_case is passed here, the comparison is case-insensitive.