boost::urls::segments_ref::insert

Insert segments

Synopsis

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


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

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.

None of the character buffers referenced by the range may overlap the character buffer of the underlying url, or else the behavior is undefined.


std::is_convertible< std::iterator_traits< FwdIt >::reference_type, core::string_view >::value == true

Calls to allocate may throw.

An iterator to the first segment inserted, or `before` if `init.empty()`.

Name	Description
before	An iterator before which the range is inserted. This may be equal to `end()`.
first,	last The range of segments to insert.