std::basic_string<CharT,Traits,Allocator>::replace
basic_string& replace( size_type pos, size_type count, const basic_string& str ); |
(1) | (constexpr since C++20) |
basic_string& replace( const_iterator first, const_iterator last, const basic_string& str ); |
(2) | (constexpr since C++20) |
(3) | ||
basic_string& replace( size_type pos, size_type count, const basic_string& str, |
(until C++14) | |
basic_string& replace( size_type pos, size_type count, const basic_string& str, |
(since C++14) (constexpr since C++20) |
|
basic_string& replace( size_type pos, size_type count, const CharT* cstr, size_type count2 ); |
(4) | (constexpr since C++20) |
basic_string& replace( const_iterator first, const_iterator last, const CharT* cstr, size_type count2 ); |
(5) | (constexpr since C++20) |
basic_string& replace( size_type pos, size_type count, const CharT* cstr ); |
(6) | (constexpr since C++20) |
basic_string& replace( const_iterator first, const_iterator last, const CharT* cstr ); |
(7) | (constexpr since C++20) |
basic_string& replace( size_type pos, size_type count, size_type count2, CharT ch ); |
(8) | (constexpr since C++20) |
basic_string& replace( const_iterator first, const_iterator last, size_type count2, CharT ch ); |
(9) | (constexpr since C++20) |
template< class InputIt > basic_string& replace( const_iterator first, const_iterator last, |
(10) | (constexpr since C++20) |
basic_string& replace( const_iterator first, const_iterator last, std::initializer_list<CharT> ilist ); |
(11) | (since C++11) (constexpr since C++20) |
template< class StringViewLike > basic_string& replace( size_type pos, size_type count, |
(12) | (since C++17) (constexpr since C++20) |
template< class StringViewLike > basic_string& replace( const_iterator first, const_iterator last, |
(13) | (since C++17) (constexpr since C++20) |
template< class StringViewLike > basic_string& replace( size_type pos, size_type count, |
(14) | (since C++17) (constexpr since C++20) |
Replaces the characters in the range [
begin() + pos,
begin() + std::min(pos + count, size()))
or [
first,
last)
with given characters.
[
pos2,
std::min(pos2 + count2, str.size()))
of str.[
cstr,
cstr + count2)
.[
cstr,
cstr + Traits::length(cstr))
.[
first2,
last2)
as if by replace(first, last, basic_string(first2, last2, get_allocator())).std::basic_string_view<CharT, Traits>> is true and std::is_convertible_v<const StringViewLike&, const CharT*> is false.
std::basic_string_view<CharT, Traits>> is true and std::is_convertible_v<const StringViewLike&, const CharT*> is false.
If [
begin(),
first)
or [
first,
last)
is not a valid range, the behavior is undefined.
Contents |
[edit] Parameters
pos | - | start of the substring that is going to be replaced |
count | - | length of the substring that is going to be replaced |
first, last | - | range of characters that is going to be replaced |
str | - | string to use for replacement |
pos2 | - | start of the substring to replace with |
count2 | - | number of characters to replace with |
cstr | - | pointer to the character string to use for replacement |
ch | - | character value to use for replacement |
first2, last2 | - | range of characters to use for replacement |
ilist | - | initializer list with the characters to use for replacement |
t | - | object (convertible to std::basic_string_view) with the characters to use for replacement |
Type requirements | ||
-InputIt must meet the requirements of LegacyInputIterator.
|
[edit] Return value
*this.
[edit] Exceptions
If the operation would result in size
() >
max_size
(), throws std::length_error.
If an exception is thrown for any reason, these functions have no effect (strong exception safety guarantee).
[edit] Example
This section is incomplete Reason: no example |
[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR | Applied to | Behavior as published | Correct behavior |
---|---|---|---|
LWG 847 | C++98 | there was no exception safety guarantee | added strong exception safety guarantee |
LWG 1323 | C++98 | the types of first and last were iterator
|
changed to const_iterator
|
LWG 2946 | C++17 | overloads (12,13) caused ambiguity in some cases | avoided by making them templates |
[edit] See also
(C++23) |
replaces specified portion of a string with a range of characters (public member function) |
(C++11) |
replaces occurrences of a regular expression with formatted replacement text (function template) |
replaces all values satisfying specific criteria with another value (function template) |