boost::urls::params_encoded_ref::insert

Insert params

Synopsis

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

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

Description

This function inserts the params in an initializer-list before the specified position.

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

The strings referenced by the inputs must not come from the underlying url, or else the behavior is undefined.

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

Strong guarantee.

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

Exceptions

Name Thrown on

`init`

contains an invalid percent&hyphen;encoding&period;

Return Value

An iterator to the first element inserted, or `before` if `init.size() == 0`.

Parameters

Name Description

before

An iterator before which the element is inserted&period; This may be equal to &grave;end()&grave;&period;

init

The list of params to insert&period;

Created with MrDocs