Insert segments

Synopsis

Declared in header </boost/url/segments_ref.hpp#L377[boost/url/segments_ref.hpp,window=blank_]>

segments_base::iterator
insert(
    segments_base::iterator before,
    string_view s);

Description

This function inserts a segment before the specified position. Reserved characters in the segment are automatically escaped. All iterators that are equal to before or come after are invalidated.

Complexity

Linear in s.size() + this->url().encoded_resource().size().

Exception Safety

Strong guarantee. Calls to allocate may throw.

Return Value

  • iterator

Parameters

Name Type

before

iterator

s

string_view