boost::urls::segments_encoded_ref::replace :: Boost Libraries Documentation

# boost::urls::segments_encoded_ref::replace

Replace segments

## Synopses

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

Replace segments

    iterator
    replace(
        iterator pos,
        pct_string_view s);

» more...

Replace segments

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

» more...

Replace segments

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

» more...

Replace segments

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

» more...

## Exceptions

Name | Thrown on
`system_error` | The string contains an invalid percent‐encoding.

## Return Value

- An iterator to the replaced segment.

- An iterator to the new segment.

- An iterator to the first segment inserted, or one past `to` if `init.size() == 0`.

## Parameters

Name | Description
--- | ---
pos | An iterator to the segment.
s | The string to assign.
from | The first element in the range of segments to replace.
to | One past the last element in the range of segments to replace.
init | The list of segments to assign.
first | The first element in the new range of segments.
last | One past the last element in the new range of segments.

Created with MrDocs