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

# boost::urls::segments_encoded_ref::replace

Replace segments

## Synopsis

Declared in `<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.

## Complexity

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

## Exception Safety

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

## Exceptions

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

## Return Value

An iterator to the new segment.

## Parameters

Name | Description
--- | ---
from | The first element in the range of segments to replace.
to | One past the last element in the range of segments to replace.
s | The string to assign.

Created with MrDocs