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 + count2) is not a valid range, the behavior is undefined.[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.
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.
| ||
Return value
*this.
Exceptions
If the operation would cause size() to exceed max_size(), throws std::length_error.
If an exception is thrown for any reason, these functions have no effect (strong exception safety guarantee).
Example
| This section is incomplete Reason: no example |
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 |
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) |