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

basic_static_string::replace (8 of 14 overloads)

Replace a part of the string.

Synopsis

template<
    std::size_t M>
constexpr basic_static_string&
replace(
    const_iterator i1,
    const_iterator i2,
    const basic_static_string< M, CharT, Traits >& str);

Description

Replaces the characters in the range {i1, i2) with those of str.

Precondition

{i1, i2)is a valid range.

Exception Safety

Strong guarantee.

Remarks

The replacement is done unchecked when the capacity of str differs from that of the string the function is called on. All references, pointers, or iterators referring to contained elements are invalidated. Any past-the-end iterators are also invalidated.

Template Parameters

Type	Description
`M`	The size of the input string.

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.
`str`	The string to replace with.

Exceptions

Type	Thrown On
`std::length_error`	`size() + (str.size() - std::distance(i1, i2)) > max_size()`