boost::urls::segments_encoded_ref::replace

Replace segments

Synopsis

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


iterator
replace(
    iterator from,
    iterator to,
    pct_string_view s);

Description

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

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

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

Strong guarantee.

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

Exceptions

Name	Thrown on
`The`	string contains an invalid percent-encoding.

Return Value

An iterator to the new segment.

Parameters

Name	Description
from,	to The range of segments to replace.
s	The string to assign.