segments_ref::insert (1 of 3 overloads)

Insert segments.

iterator
insert(
    iterator before,
    string_view s);

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.

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

Strong guarantee. Calls to allocate may throw.

An iterator to the inserted segment.

Name	Description
`before`	An iterator before which the segment will be inserted. This may be equal to `end()`.
`s`	The segment to insert.