boost::urls::segments_ref::replace

Replace segments

Synopsis

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

iterator
replace(
    iterator pos,
    core::string_view s);

» more...

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

» more...

iterator
replace(
    iterator from,
    iterator to,
    std::initializer_list<core::string_view> init);

» more...

template<class FwdIt>
iterator
replace(
    iterator from,
    iterator to,
    FwdIt first,
    FwdIt last);

» more...

Description

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

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

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

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.

from,

to The range of segments to replace.

init

The list of segments to assign.

first,

last The range of segments to assign.

Created with MrDocs