std::list<T,Allocator>::insert
来自cppreference.com
                    
                                        
                    
                    
                                                            
                    
| (1) | ||
|   iterator insert( iterator pos, const T& value );  | 
(C++11 前) | |
|   iterator insert( const_iterator pos, const T& value );  | 
(C++11 起) | |
|   iterator insert( const_iterator pos, T&& value );  | 
(2) | (C++11 起) | 
| (3) | ||
|   void insert( iterator pos, size_type count, const T& value );  | 
(C++11 前) | |
|   iterator insert( const_iterator pos, size_type count, const T& value );  | 
(C++11 起) | |
| (4) | ||
|   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 起) | |
|   iterator insert( const_iterator pos, std::initializer_list<T> ilist );  | 
(5) | (C++11 起) | 
插入元素到容器中的指定位置。
1-2) 在 
pos 前插入 value 。3) 在 
pos 前插入 value 的 count 个副本。4) 在 
若 
pos 前插入来自范围 [first, last) 的元素。 
 | 
 若   | 
(C++11 前) | 
| 
 此重载仅若   | 
(C++11 起) | 
first 和 last 是指向 *this 中的迭代器,则行为未定义。5) 在 
pos 前插入来自 initializer_list ilist 的元素。没有引用和迭代器被非法化。
参数
| pos | - |  将内容插入到其前的迭代器。 pos 可为 end() 迭代器
 | 
| value | - | 要插入的元素值 | 
| first, last | - | 要插入的元素范围,不能是指向调用 insert 所用的容器中的迭代器 | 
| ilist | - | 要插入的值来源的 initializer_list | 
| 类型要求 | ||
 - 为使用重载 (1) , T 必须满足可复制插入 (CopyInsertable)  的要求。
 | ||
 - 为使用重载 (2) , T 必须满足可移动插入 (MoveInsertable)  的要求。
 | ||
 - 为使用重载 (3) , T 必须满足可复制赋值 (CopyAssignable)  和 可复制插入 (CopyInsertable)  的要求。
 | ||
 - 为使用重载 (4,5) , T 必须满足可就位构造 (EmplaceConstructible)  的要求。
  | ||
返回值
1-2) 指向被插入 
value 的迭代器。3) 指向首个被插入元素的迭代器,或若 count==0 则为 
pos 。4) 指向首个被插入元素的迭代器,或若 first==last 则为 
pos 。5) 指向首个被插入元素的迭代器,或若 
ilist 为空则为 pos 。复杂度
1-2) 常数。
3) 与 count 成线性。
4) 与 std::distance(first, last) 成线性。
5) 与 ilist.size() 成线性。
异常
若抛出异常,则无效果(强异常保证)。
参阅
|    (C++11)  | 
  原位构造元素  (公开成员函数)  | 
|   插入元素到容器起始  (公开成员函数)  | |
|    将元素添加到容器末尾  (公开成员函数)  |