Insert segments
Synopsis
Declared in <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 |
The beginning of the range of segments to insert. |
last |
The end of the range of segments to insert. |
Created with MrDocs