string::replace (2 of 5 overloads)

Replace a range with a string.

Synopsis

string&
replace(
    const_iterator first,
    const_iterator last,
    string_view sv);

Description

Replaces the characters in the range {first, last) with those of sv.

Precondition

{first, last)is a valid range.

Strong guarantee.

Remarks

All references, pointers, or iterators referring to contained elements are invalidated. Any past-the-end iterators are also invalidated.

Return Value

*this

Parameters

Name	Description
`first`	An iterator referring to the first character to replace.
`last`	An iterator one past the end of the last character to replace.
`sv`	The `string_view` to replace with.

Exceptions

Type	Thrown On
`std::length_error`	`size() + (sv.size() - std::distance(first, last)) > max_size()`

Boost C++ Libraries