Function segments_ref::replace

Replace segments

Synopsis

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

segments_base::iterator
replace(
    segments_base::iterator from,
    segments_base::iterator to,
    core::string_view s);

Description

This function replaces a range of segments with one segment. Reserved characters in the string are automatically escaped.

All iterators that are equal to from or come after are invalidated.

Complexity

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

Exception Safety

Strong guarantee. Calls to allocate may throw.

Return Value

An iterator to the new segment.

Parameters

Name Description

from,

to The range of segments to replace.

s

The string to assign.