boost::urls::params_encoded_ref::erase

Erase params

Synopsis

Declared in <include/boost/url/params_encoded_ref.hpp>

iterator
erase(iterator pos) noexcept;

» more…​

iterator
erase(
    iterator first,
    iterator last) noexcept;

» more…​

std::size_t
erase(
    pct_string_view key,
    ignore_case_param ic = = {}) noexcept;

» more…​

Description

This function removes an element from the container.

All iterators that are equal to `pos` or come after are invalidated.

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

params_encoded_ref::iterator it = u.encoded_params().erase( u.encoded_params().begin() );

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

Linear in `this‐>url().encoded_query().size()`.

Throws nothing.

Exceptions

Name Thrown on

`key`

contains an invalid percent‐encoding.

Return Value

An iterator to one past the removed element.

Parameters

Name Description

pos

An iterator to the element&period;

first,

last The range of params to erase&period;

key

The key to match&period; By default, a case&hyphen;sensitive comparison is used&period;

ic

An optional parameter&period; If the value xref:boost/urls/ignore_case.adoc[ignore&lowbar;case] is passed here, the comparison is case&hyphen;insensitive&period;

Created with MrDocs