std::basic_string::replace
From cppreference.com
< cpp | string | basic string
basic_string& replace( size_type pos, size_type count,
const basic_string& str ); |
(1) | |
basic_string& replace( const_iterator first, const_iterator last,
const basic_string& str ); |
(1) | |
(2) | ||
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) | |
template< class InputIt >
basic_string& replace( const_iterator first, const_iterator last, |
(3) | |
basic_string& replace( size_type pos, size_type count,
const CharT* cstr, size_type count2 ); |
(4) | |
basic_string& replace( const_iterator first, const_iterator last,
const CharT* cstr, size_type count2 ); |
(4) | |
basic_string& replace( size_type pos, size_type count,
const CharT* cstr ); |
(5) | |
basic_string& replace( const_iterator first, const_iterator last,
const CharT* cstr ); |
(5) | |
basic_string& replace( size_type pos, size_type count,
size_type count2, CharT ch ); |
(6) | |
basic_string& replace( const_iterator first, const_iterator last,
size_type count2, CharT ch ); |
(6) | |
basic_string& replace( const_iterator first, const_iterator last,
std::initializer_list<CharT> ilist ); |
(7) | (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
3) characters in the range
[first2, last2)
; This overload does not participate in overload resolution if InputIt
does not satisfy InputIterator
. (since C++11)
4) first
count2
charcters of the character string pointed to by cstr
;
5) null-terminated character string pointed to by
cstr
;
6)
count2
copies of character ch
;
7) 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 |
ilist | - | initializer list with the characters to use for replacement |
Type requirements | ||
-
InputIt must meet the requirements of InputIterator .
|
[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
)
In any case, if an exception is thrown for any reason, this function has no effect (strong exception guarantee). (since C++11)
[edit] Example
Run this code
#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.