c++11 标准模板（STL）string（八）
string操作
插入字符 insert
std::basic_string::insert 1) 在位置 index 插入 count 个字符 ch 的副本。
basic_string& insert( size_type index, size_type count, CharT ch );调用示例
//在位置 index 插入 count 个字符 ch 的副本。
str.insert(2, 5, 'H');
std::cout << "str insert: " << str << std::endl << std::endl;2) 在位置 index 插入 s 所指向的空终止字符串。字符串的长度由首个空字符，用 Traits::length(s) 确定。
basic_string& insert( size_type index, const CharT* s );调用示例
// 在位置 index 插入 s 所指向的空终止字符串。
// 字符串的长度由首个空字符，用 Traits::length(s) 确定。
str.insert(2, str1.c_str());
std::cout << "str insert: " << str << std::endl << std::endl;3) 在位置 index 插入范围 [s, s+count) 中的字符。范围能含有空字符。
basic_string& insert( size_type index, const CharT* s, size_type count );调用示例
// 在位置 index 插入范围 [s, s+count) 中的字符。范围能含有空字符。
string str2 = "abcdefg hijk";
str = str2;
str.insert(2, str.c_str(), str2.size());
std::cout << "str insert: " << str << std::endl << std::endl;4) 在位置 index 插入 string str 。
basic_string& insert( size_type index, const basic_string& str );调用示例
// 在位置 index 插入 string str 。
str = str2;
str.insert(2, str2);
std::cout << "str insert: " << str << std::endl << std::endl;5) 在位置 index 插入由 str.substr(index_str, count) 获得的 string 。
basic_string& insert( size_type index, const basic_string& str,
size_type index_str, size_type count );调用示例
// 在位置 index 插入由 str.substr(index_str, count) 获得的 string 。
str = str2;
str.insert(2, str2, 0, 5);
std::cout << "str insert: " << str << std::endl << std::endl;6) 在 pos 所指向的字符前插入字符 ch 。
iterator insert( iterator pos, CharT ch ); (C++11 前)
iterator insert( const_iterator pos, CharT ch ); (C++11 起)
调用示例
// 在 pos 所指向的字符前插入字符 ch 。
str = str2;
str.insert(str.begin() + 2, 'K');
std::cout << "str insert: " << str << std::endl << std::endl;7) 在 pos 所指向的元素（若存在）前插入 count 个字符 ch 的副本。
void insert( iterator pos, size_type count, CharT ch ); (C++11 前)
iterator insert( const_iterator pos, size_type count, CharT ch ); (C++11 起)
调用示例
// 在 pos 所指向的元素（若存在）前插入 count 个字符 ch 的副本。
str = str2;
str.insert(str.begin() + 2, 5, 'K');
std::cout << "str insert: " << str << std::endl << std::endl;8) 在 pos 所指向的元素（若存在）前插入来自范围 [first, last) 的元素。
若 InputIt 不满足遗留输入迭代器 (LegacyInputIterator) 则此重载不参与重载决议。 (C++11 起)
template< class InputIt >
void insert( iterator pos, InputIt first, InputIt last ); (C++11 前)
template< class InputIt >
iterator insert( const_iterator pos, InputIt first, InputIt last ); (C++11 起)
调用示例
// 在 pos 所指向的元素（若存在）前插入来自范围 [first, last) 的元素。
str = str2;
str.insert(str.begin() + 2, str2.begin() + 1, str2.begin() + 5);
std::cout << "str insert: " << str << std::endl << std::endl; 9) 在 pos 所指向的元素（若存在）前插入来自 initializer_list ilist 的字符。
iterator insert( const_iterator pos, std::initializer_list ilist ); // 在 pos 所指向的元素（若存在）前插入来自 initializer_list ilist 的字符。
str = str2;
str.insert(str.begin() + 2, {'A', 'B', 'C'});
std::cout << "str insert: " << str << std::endl << std::endl;参数
| index | - | 插入内容到的位置 |
| pos | - | 将插入字符到其前的迭代器 |
| ch | - | 要插入的字符 |
| count | - | 要插入的字符数 |
| s | - | 指向要插入的字符串的指针 |
| str | - | 要插入的 string |
| first, last | - | 定义要插入字符的范围 |
| index_str | - | string str 中要插入的首字符位置 |
| ilist | - | 要插入的字符来源的 std::initializer_list |
| t | - | 要插入的字符来源对象（可转换为 std::basic_string_view ） |
| 类型要求 | ||
- InputIt 必须满足遗留输入迭代器 (LegacyInputIterator) 的要求。 |
||
返回值
1-5,10-11) *this
6-9) 指代首个被插入字符的迭代器，或若未插入字符则为 pos （ count == 0 或 ilist.size() == 0 或 first == last ）
异常
1-4, 10) 若 index > size() 则为 std::out_of_range 。
5) 若 index > size() 或若 index_str > str.size() 则抛出 std::out_of_range 。
11) 若 index > size() 或若 index_str > sv.size() 则抛出 std::out_of_range 。
所有情况下，若 size() + ins_count > max_size() 则抛出 std::length_error ，其中 ins_count 是将要插入的字符数。并且可能抛出 Allocator::allocate 所抛的任何异常。
| 任何情况下，若因任何原因抛异常，则此函数无效果（强异常保证）。 |
(C++11 起) |
缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
调用示例
std::cout << "test_operation begin" << std::endl;
string str = "abcdefg hijk";
string str1 = "str1";
// 插入字符
//在位置 index 插入 count 个字符 ch 的副本。
str.insert(2, 5, 'H');
std::cout << "str insert: " << str << std::endl << std::endl;
// 在位置 index 插入 s 所指向的空终止字符串。
// 字符串的长度由首个空字符，用 Traits::length(s) 确定。
str.insert(2, str1.c_str());
std::cout << "str insert: " << str << std::endl << std::endl;
// 在位置 index 插入范围 [s, s+count) 中的字符。范围能含有空字符。
string str2 = "abcdefg hijk";
str = str2;
str.insert(2, str.c_str(), str2.size());
std::cout << "str insert: " << str << std::endl << std::endl;
// 在位置 index 插入 string str 。
str = str2;
str.insert(2, str2);
std::cout << "str insert: " << str << std::endl << std::endl;
// 在位置 index 插入由 str.substr(index_str, count) 获得的 string 。
str = str2;
str.insert(2, str2, 0, 5);
std::cout << "str insert: " << str << std::endl << std::endl;
// 在 pos 所指向的字符前插入字符 ch 。
str = str2;
str.insert(str.begin() + 2, 'K');
std::cout << "str insert: " << str << std::endl << std::endl;
// 在 pos 所指向的元素（若存在）前插入 count 个字符 ch 的副本。
str = str2;
str.insert(str.begin() + 2, 5, 'K');
std::cout << "str insert: " << str << std::endl << std::endl;
// 在 pos 所指向的元素（若存在）前插入来自范围 [first, last) 的元素。
str = str2;
str.insert(str.begin() + 2, str2.begin() + 1, str2.begin() + 5);
std::cout << "str insert: " << str << std::endl << std::endl;
// 在 pos 所指向的元素（若存在）前插入来自 initializer_list ilist 的字符。
str = str2;
str.insert(str.begin() + 2, {'A', 'B', 'C'});
std::cout << "str insert: " << str << std::endl << std::endl;
