Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext
basic_static_string::replace (11 of 14 overloads)

Replace a part of the string.

Synopsis
constexpr basic_static_string&
replace(
    const_iterator i1,
    const_iterator i2,
    const_pointer s);
Description

Replaces the characters in the range {i1, i2) with those of {s, s + len), where the length of the string len is traits_type::length(s).

Precondition

{i1, i2)shall be 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

i1

An iterator referring to the first character to replace.

i2

An iterator referring past the end of the last character to replace.

s

The string to replace with.

Exceptions

Type

Thrown On

std::length_error

size() + (len - std::distance(i1, i2)) > max_size()


PrevUpHomeNext