Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext
basic_static_string::replace (15 of 19 overloads)

Replace a range with copies of a character.

Synopsis
BOOST_STATIC_STRING_CPP14_CONSTEXPR basic_static_string&
replace(
    const_iterator i1,
    const_iterator i2,
    size_type n,
    value_type c);
Description

Replaces the characters in the range [i1, i2) with n copies of c.

Precondition

[i1, i2) 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

i1

An iterator referring to the first character to replace.

i2

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

n

The number of characters to replace with.

c

The character to replace with.

Exceptions

Type

Thrown On

std::length_error

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


PrevUpHomeNext