boost::urls::segments_encoded_ref::insert

Insert segments

Synopsis

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

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

Description

This function inserts the segments in a range before the specified position. Reserved characters in the range are automatically escaped. Escapes in the range are preserved.

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, pct_string_view >::value == true

Linear in `std::distance( first, last ) + this‐>url().encoded_resource().size()`.

Strong guarantee.

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

Exceptions

Name Thrown on

The

range contains an invalid percent&hyphen;encoding&period;

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&period; This may be equal to &grave;end()&grave;&period;

first,

last The range of segments to insert&period;

Created with MrDocs