Remove the value on an element

Synopsis

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

params_base::iterator
unset(params_base::iterator pos) noexcept;

Description

This function removes the value of an element at the specified position. After the call returns, has_value for the element is false. All iterators that are equal to pos or come after are invalidated.

Example

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

u.params().unset( u.params().begin() );

assert( u.encoded_query() == "first&last=Doe" );

Complexity

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

Exception Safety

Throws nothing.

Return Value

  • iterator

Parameters

Name Type

pos

iterator