std::basic_string::replace
From Cppreference
| basic_string& replace( size_type pos, size_type count,
const basic_string& str ); | (1) | |
| basic_string& replace( size_type pos, size_type count,
const basic_string& str, | (2) | |
| basic_string& replace( size_type pos, size_type count,
const CharT* cstr, size_type count2 ); | (3) | |
| basic_string& replace( size_type pos, size_type count,
const CharT* cstr ); | (4) | |
| basic_string& replace( size_type pos, size_type count,
size_type count2, CharT ch ); | (5) | |
| basic_string& replace( const_iterator first, const_iterator last,
std::initializer_list<CharT> ilist ); | (6) | (since C++11) |
Replaces the part of the string indicated by either [pos, pos + count) or [first, last) with a new string.
The new string can be one of:
1) string str
2) substring [pos2, pos2 + count2) of str or characters in the range [first2, last2)
3) first count2 charcters of the character string pointed to by cstr
4) null-terminated character string pointed to by cstr
5) count2 copies of character ch
6) characters in the initializer list ilist
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 |
| init | - | initializer list with the characters to use for replacement |
[edit] Return value
*this
[edit] Exceptions
std::out_of_range if pos > length() or pos2 > str.length()
std::length_error if the resulting string will exceed maximum possible string length (std::string::npos - 1)
[edit] Example
#include <iostream> #include <string> int main() { std::string str("The quick brown fox jumps over the lazy dog."); str.replace(10, 5, "red"); // (4) str.replace(str.begin(), str.begin() + 3, 1, 'A'); // (5) std::cout << str << '\n'; }
Output:
A quick red fox jumps over the lazy dog.
