boost::urls::params_encoded_ref::insert

Insert params

Synopsis

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

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

» more...

iterator
insert(
    iterator before,
    std::initializer_list<param_pct_view> init);

» more...

template<class FwdIt>
iterator
insert(
    iterator before,
    FwdIt first,
    FwdIt last);

» more...

Description

This function inserts a param before the specified position.

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

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

Strong guarantee.

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

Exceptions

Name Thrown on
[object Object]

contains an invalid percent-encoding.

[object Object]

contains an invalid percent-encoding.

[object Object]

range 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.

init

The list of params to insert.

first,

last The range of params to insert.

Created with MrDocs