Insert params
Synopsis
Declared in header <boost/url/params_encoded_ref.hpp>
Description
This function inserts a range of params before the specified position.
All iterators that are equal to
before
or come after are invalidated.
Note
|
The strings referenced by the inputs must not come from the underlying url, or else the behavior is undefined. |
Mandates
std::is_convertible< std::iterator_traits< FwdIt >::reference_type, param_pct_view >::value == true
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 |
---|---|
|
The range contains an invalid percent-encoding. |
Return Value
An iterator to the first
element inserted, or before
if
first == last
.
Parameters
Name | Description |
---|---|
before |
An iterator before which
the element is inserted. This may
be equal to |
first, |
last The range of params to insert. |