Function params_encoded_ref::insert

Insert params

Synopsis

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

params_encoded_base::iterator
insert(
    params_encoded_base::iterator before,
    const param_pct_view& p);

Description

This function inserts a param before the specified position.

All iterators that are equal to before or come after are invalidated.

Complexity

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

Exception Safety

Strong guarantee. Calls to allocate may throw. Exceptions thrown on invalid input.

Exceptions

Name Thrown on

system_error

p contains an invalid percent-encoding.

Return Value

An iterator to the inserted element.

Parameters

Name Description

before

An iterator before which the param is inserted. This may be equal to end().

p

The param to insert.