C++

参考

<string>

basic_string

public member function
<string>

std::basic_string::replace

string (1)
basic_string& replace (size_type pos, size_type len, const basic_string& str);basic_string& replace (iterator i1,   iterator i2,   const basic_string& str);
substring (2)
basic_string& replace (size_type pos, size_type len, const basic_string& str,                       size_type subpos, size_type sublen);
c-string (3)
basic_string& replace (size_type pos, size_type len, const charT* s);basic_string& replace (iterator i1,   iterator i2,   const charT* s);
buffer (4)
basic_string& replace (size_type pos, size_type len, const charT* s, size_type n);basic_string& replace (iterator i1,   iterator i2,   const charT* s, size_type n);
fill (5)
basic_string& replace (size_type pos, size_type len, size_type n, charT c);basic_string& replace (iterator i1,   iterator i2,   size_type n, charT c);
range (6)
template <class InputIterator>  basic_string& replace (iterator i1, iterator i2,                       InputIterator first, InputIterator last);
string (1)
basic_string& replace (size_type pos,     size_type len,     const basic_string& str);basic_string& replace (const_iterator i1, const_iterator i2, const basic_string& str);
substring (2)
basic_string& replace (size_type pos, size_type len, const basic_string& str,                       size_type subpos, size_type sublen);
c-string (3)
basic_string& replace (size_type pos,     size_type len,     const charT* s);basic_string& replace (const_iterator i1, const_iterator i2, const charT* s);
buffer (4)
basic_string& replace (size_type pos,     size_type len,     const charT* s, size_type n);basic_string& replace (const_iterator i1, const_iterator i2, const charT* s, size_type n);
fill (5)
basic_string& replace (size_type pos,     size_type len,     size_type n, charT c);basic_string& replace (const_iterator i1, const_iterator i2, size_type n, charT c);
range (6)
template <class InputIterator>  basic_string& replace (const_iterator i1, const_iterator i2,                       InputIterator first, InputIterator last);
初始化列表 (7)
basic_string& replace (const_iterator i1, const_iterator i2, initializer_list<charT> il);
string (1)
basic_string& replace (size_type pos,     size_type len,     const basic_string& str);basic_string& replace (const_iterator i1, const_iterator i2, const basic_string& str);
substring (2)
basic_string& replace (size_type pos, size_type len, const basic_string& str,                       size_type subpos, size_type sublen = npos);
c-string (3)
basic_string& replace (size_type pos,     size_type len,     const charT* s);basic_string& replace (const_iterator i1, const_iterator i2, const charT* s);
buffer (4)
basic_string& replace (size_type pos,     size_type len,     const charT* s, size_type n);basic_string& replace (const_iterator i1, const_iterator i2, const charT* s, size_type n);
fill (5)
basic_string& replace (size_type pos,     size_type len,     size_type n, charT c);basic_string& replace (const_iterator i1, const_iterator i2, size_type n, charT c);
range (6)
template <class InputIterator>  basic_string& replace (const_iterator i1, const_iterator i2,                       InputIterator first, InputIterator last);
初始化列表 (7)
basic_string& replace (const_iterator i1, const_iterator i2, initializer_list<charT> il);
替换字符串的部分内容
替换从字符pos开始并跨越len个字符的字符串部分（或者[i1,i2)) 之间范围内的字符串部分）为新的内容。

(1) string
复制 *str*。
(2) substring
复制str中从字符位置subpos开始并跨越sublen个字符的部分（或者直到str的末尾，如果str太短或者sublen是basic_string::npos）。
(3) c-string
复制 *s* 指向的空终止字符序列（C 字符串）。
长度通过调用traits.length(s) 确定。.
(4) buffer
从 *s* 指向的字符数组中复制前 *n* 个字符。
(5) fill
将字符串的部分内容替换为n个字符c的连续副本。
(6) range
复制范围内的字符序列[first,last)，以相同的顺序。
(7) 初始化列表
按相同顺序复制 *il* 中的每个字符。

参数

str
另一个具有相同类型的basic_string对象（具有相同的类模板参数charT, 特性 (traits)和Alloc），其值被复制。
pos
要替换的第一个字符的位置。
如果它大于字符串长度，则抛出out_of_range。
len
要替换的字符数（如果字符串较短，则会替换尽可能多的字符）。
basic_string::npos值表示直到字符串末尾的所有字符。
subpos
str中作为替换复制到对象的第一个字符的位置。
如果它大于str的长度，则抛出out_of_range。
sublen
要复制的子字符串的长度（如果字符串较短，则会复制尽可能多的字符）。
basic_string::npos值表示直到str末尾的所有字符。
s
指向字符数组的指针（例如c-string）。
n
要复制的字符数。
c
字符值，重复 *n* 次。
first, last
指向范围内初始位置和最终位置的输入迭代器。 使用的范围是[first,last)，其中包括first和last之间的所有字符，包括first指向的字符，但不包括last指向的字符。
函数模板参数InputIterator应为指向可转换为charT.
il
il
这些对象是从初始化列表声明符自动构造的。

charT是 basic_string 的字符类型（即，它的第一个模板参数）。
成员类型size_type是一种无符号整型类型。

返回值

*this

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
// replacing in a string
#include <iostream>
#include <string>

int main ()
{
  std::string base="this is a test string.";
  std::string str2="n example";
  std::string str3="sample phrase";
  std::string str4="useful.";

  // replace signatures used in the same order as described above:

  // Using positions:                 0123456789*123456789*12345
  std::string str=base;           // "this is a test string."
  str.replace(9,5,str2);          // "this is an example string." (1)
  str.replace(19,6,str3,7,6);     // "this is an example phrase." (2)
  str.replace(8,10,"just a");     // "this is just a phrase."     (3)
  str.replace(8,6,"a shorty",7);  // "this is a short phrase."    (4)
  str.replace(22,1,3,'!');        // "this is a short phrase!!!"  (5)

  // Using iterators:                                               0123456789*123456789*
  str.replace(str.begin(),str.end()-3,str3);                    // "sample phrase!!!"      (1)
  str.replace(str.begin(),str.begin()+6,"replace");             // "replace phrase!!!"     (3)
  str.replace(str.begin()+8,str.begin()+14,"is coolness",7);    // "replace is cool!!!"    (4)
  str.replace(str.begin()+12,str.end()-4,4,'o');                // "replace is cooool!!!"  (5)
  str.replace(str.begin()+11,str.end(),str4.begin(),str4.end());// "replace is useful."    (6)
  std::cout << str << '\n';
  return 0;
}

输出
replace is useful.


复杂度

未指定，但通常高达新字符串长度的线性。

迭代器有效性

与此对象相关的任何迭代器、指针和引用都可能失效。

数据竞争

对象被修改。

异常安全

强保证： 如果抛出异常，则 basic_string 中没有任何更改。

如果已知s没有指向足够长的数组，或者如果指定的范围是[first,last)无效，则会导致未定义行为。

如果pos大于字符串长度，或者subpos大于str的长度，则会抛出out_of_range异常。
如果结果 字符串长度 超过 max_size，则会抛出 length_error 异常。
如果该类型使用默认分配器，如果函数需要分配存储空间但失败，则会抛出bad_alloc异常。

另见

basic_string::insert
插入字符串 (public member function)
basic_string::append
追加到字符串 (public member function)
basic_string::substr
生成子字符串 (公共成员函数)
basic_string::erase
从字符串中删除字符 (公共成员函数)
basic_string::assign
将内容分配给字符串 (public member function)