Function segments_encoded_ref::replace

Replace segments

Synopsis

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

segments_encoded_base::iterator
replace(
    segments_encoded_base::iterator pos,
    pct_string_view s);

Description

This function replaces the segment at the specified position. Reserved characters in the string are automatically escaped. Escapes in the string are preserved.

All iterators that are equal to pos 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 replaced segment.

Parameters

Name Description

pos

An iterator to the segment.

s

The string to assign.