boost::urls::segments_encoded_ref::replace

Replace segments

Synopsis

iterator
replace(
    iterator pos,
    pct_string_view s);

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

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

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

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.

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

Strong guarantee.

Calls to allocate may throw.

Exceptions

Return Value

An iterator to the replaced segment.

Parameters