Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
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.

Exception Safety

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()


PrevUpHomeNext