boost::urls::params_ref::replace :: Boost Libraries Documentation

# boost::urls::params_ref::replace

Replace elements

## Synopsis

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

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

## Description

This function replaces a range of elements with a range of params.

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

| The strings referenced by the inputs must not come from the underlying url, or else the behavior is undefined.

## Mandates

    std::is_convertible< std::iterator_traits< FwdIt >::reference_type, param_view >::value == true

## Complexity

Linear in `this‐>url().encoded_query().size()`.

## Exception Safety

Strong guarantee. Calls to allocate may throw.

## Return Value

- An iterator to the first element inserted, or one past `to` if `first == last`.

- An iterator to the first element inserted, or one past `to` if `first == last`.

## Parameters

Name | Description
--- | ---
from | The first element to replace.
to | One past the last element to replace.
first | The first element to insert.
last | One past the last element to insert.

Created with MrDocs