C++

参考

<string>

string

public member function
<string>

std::string::insert

string (1)
 string& insert (size_t pos, const string& str);
substring (2)
 string& insert (size_t pos, const string& str, size_t subpos, size_t sublen);
c-string (3)
 string& insert (size_t pos, const char* s);
buffer (4)
 string& insert (size_t pos, const char* s, size_t n);
fill (5)
 string& insert (size_t pos, size_t n, char c);    void insert (iterator p, size_t n, char c);
single character (6)
iterator insert (iterator p, char c);
range (7)
template <class InputIterator>   void insert (iterator p, InputIterator first, InputIterator last);
string (1)
 string& insert (size_t pos, const string& str);
substring (2)
 string& insert (size_t pos, const string& str, size_t subpos, size_t sublen);
c-string (3)
 string& insert (size_t pos, const char* s);
buffer (4)
 string& insert (size_t pos, const char* s, size_t n);
fill (5)
 string& insert (size_t pos,   size_t n, char c);iterator insert (const_iterator p, size_t n, char c);
single character (6)
iterator insert (const_iterator p, char c);
range (7)
template <class InputIterator>iterator insert (iterator p, InputIterator first, InputIterator last);
initializer list (8)
 string& insert (const_iterator p, initializer_list<char> il);
string (1)
 string& insert (size_t pos, const string& str);
substring (2)
 string& insert (size_t pos, const string& str, size_t subpos, size_t sublen = npos);
c-string (3)
 string& insert (size_t pos, const char* s);
buffer (4)
 string& insert (size_t pos, const char* s, size_t n);
fill (5)
 string& insert (size_t pos,   size_t n, char c);iterator insert (const_iterator p, size_t n, char c);
single character (6)
iterator insert (const_iterator p, char c);
range (7)
template <class InputIterator>iterator insert (iterator p, InputIterator first, InputIterator last);
initializer list (8)
 string& insert (const_iterator p, initializer_list<char> il);
插入字符串
在由pos (或 p) 指示的字符之前，将附加字符插入到字符串中。

(1) string
插入str的副本。
(2) substring
插入str的子字符串的副本。 子字符串是以字符位置subpos开始并跨越sublen个字符的部分（或者直到str的末尾，如果str太短或sublen为npos）。
(3) c-string
插入由s指向的以null结尾的字符序列（C字符串）形成的字符串的副本。
(4) buffer
插入由s指向的字符数组中的前n个字符的副本。
(5) fill
插入n个字符c的连续副本。
(6) single character
插入字符c。
(7) range
插入范围内的字符序列的副本[first,last)，以相同的顺序。
(8) initializer list
以相同顺序插入il中每个字符的副本。

size_t 是一个无符号整数类型（与成员类型 string::size_type 相同）。

参数

pos
插入点：新内容插入到位置pos的字符之前。
如果它大于对象的length，则会抛出out_of_range。
注意：第一个字符用值表示0(不是1).
str
另一个string对象。
subpos
str中作为子字符串插入到对象中的第一个字符的位置。
如果它大于str的length，则会抛出out_of_range。
注意：str中的第一个字符用值表示0(不是1).
sublen
要复制的子字符串的长度（如果字符串较短，则会复制尽可能多的字符）。
值为npos表示直到str末尾的所有字符。
s
指向字符数组的指针（例如c-string）。
n
要插入的字符数。
c
字符值。
p
指向插入点的迭代器：新内容插入到p指向的字符之前。
iterator是一个成员类型，定义为指向字符串字符的随机访问迭代器类型。
first, last
指向范围内初始位置和最终位置的输入迭代器。 使用的范围是[first,last)，其中包括first和last之间的所有字符，包括first指向的字符，但不包括last指向的字符。
函数模板参数InputIterator应为指向可转换为char.
类型的元素的输入迭代器类型。
il
这些对象是从初始化列表声明符自动构造的。

返回值

返回对string的引用的签名，返回*this.
那些返回一个iterator，返回一个指向插入的第一个字符的迭代器。

成员类型iterator是指向字符串字符的随机访问迭代器类型。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 
// inserting into a string
#include <iostream>
#include <string>

int main ()
{
  std::string str="to be question";
  std::string str2="the ";
  std::string str3="or not to be";
  std::string::iterator it;

  // used in the same order as described above:
  str.insert(6,str2);                 // to be (the )question
  str.insert(6,str3,3,4);             // to be (not )the question
  str.insert(10,"that is cool",8);    // to be not (that is )the question
  str.insert(10,"to be ");            // to be not (to be )that is the question
  str.insert(15,1,':');               // to be not to be(:) that is the question
  it = str.insert(str.begin()+5,','); // to be(,) not to be: that is the question
  str.insert (str.end(),3,'.');       // to be, not to be: that is the question(...)
  str.insert (it+2,str3.begin(),str3.begin()+3); // (or )

  std::cout << str << '\n';
  return 0;
}
输出
to be, or not to be: that is the question...


复杂度

未指定，但通常最多为新字符串长度的线性比例。

迭代器有效性

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

数据竞争

对象被修改。

异常安全

强保证： 如果抛出异常，string 中不会有任何更改。

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

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

另见

string::append
将字符串追加到字符串 (公共成员函数)
string::replace
替换字符串的一部分 (public member function)
string::substr
生成子字符串 (公共成员函数)
string::operator=
字符串赋值 (公共成员函数)
string::operator+=
将字符串追加到字符串 (公共成员函数)