Insert segments
Synopsis
Declared in header <boost/url/segments_ref.hpp>
Description
This function inserts the segments in a range before the specified position. Reserved characters in the list are automatically escaped.
All iterators that are equal to
before
or come after are invalidated.
Note
|
None of the character buffers referenced by the range may overlap the character buffer of the underlying url, or else the behavior is undefined. |
Mandates
std::is_convertible< std::iterator_traits< FwdIt >::reference_type, core::string_view >::value == true
Complexity
Linear in std::distance( first, last ) + this->url().encoded_resource().size()
.
Exception Safety
Strong guarantee. Calls to allocate may throw.
Return Value
An iterator to the first
segment inserted, or before
if
init.empty()
.
Parameters
Name | Description |
---|---|
before |
An iterator before which
the range is inserted. This may
be equal to |
first, |
last The range of segments to insert. |