boost::urls::segments_ref::replace :: Boost Libraries Documentation

# boost::urls::segments_ref::replace

Replace segments

## Synopsis

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

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

## Description

This function replaces a range of segments with annother range of segments. Reserved characters in the new range are automatically escaped.

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

## Preconditions

None of the character buffers referenced by the new range may overlap the character buffer of the underlying url, or else the behavior is undefined.

## Complexity

Linear in `std::distance( first, last ) + this‐>url().encoded_resouce().size()`.

## Exception Safety

Strong guarantee. Calls to allocate may throw.

## Return Value

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

## Parameters

Name | Description
--- | ---
from | The beginning of the range of segments to replace.
to | The end of the range of segments to replace.
first | The beginning of the range of segments to assign.
last | The end of the range of segments to assign.

Created with MrDocs