std::list<T,Allocator>::insert - cppreference.com

提供: 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) から要素を挿入します。

`InputIt` が整数型の場合、このオーバーロードはオーバーロード (3) と同じ効果を持ちます。	(C++11未満)
オーバーロード (3) との曖昧さを回避するため、このオーバーロードは、`InputIt` が LegacyInputIterator を満たす場合にのみ、オーバーロード解決に参加します。	(C++11以上)

first および last が *this 内を指す場合、動作は未定義です。

5) pos の前に初期化子リスト ilist から要素を挿入します。

どのイテレータも参照も無効化されません。

pos	-	前に内容が挿入されるイテレータ。 `pos` は end() イテレータでも構いません
value	-	挿入する要素の値
first, last	-	挿入する要素の範囲。 insert が呼ばれたコンテナ内を指すイテレータは使用できません
ilist	-	挿入する値の初期化子リスト
型の要件
-オーバーロード (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() に比例。

例外が投げられた場合、効果はありません (強い例外保証)。