list::insert
リストの指定した位置に要素、複数の要素、または要素の範囲を挿入します。
iterator insert( iterator Where, const Type& Val ); iterator insert( iterator Where, Type&& Val ); void insert( iterator Where, size_type Count, const Type& Val ); iterator insert( iterator Where, initializer_list<Type> IList ); template<class InputIterator> void insert( iterator Where, InputIterator First, InputIterator Last );
パラメーター
パラメーター |
説明 |
Where |
最初の要素が挿入される、ターゲット リスト内の位置。 |
Val |
リストに挿入される要素の値。 |
Count |
リストに挿入される要素の数。 |
First |
コピーされる引数リストの要素範囲内にある最初の要素の位置。 |
Last |
コピーされる引数リストの要素範囲外にある最初の要素の位置。 |
戻り値
最初の 2 つの insert 関数は、新しい要素がリストに挿入される位置を指す反復子を返します。
使用例
// list_class_insert.cpp
// compile with: /EHsc
#include <list>
#include <iostream>
#include <string>
int main()
{
using namespace std;
list <int> c1, c2;
list <int>::iterator Iter;
c1.push_back(10);
c1.push_back(20);
c1.push_back(30);
c2.push_back(40);
c2.push_back(50);
c2.push_back(60);
cout << "c1 =";
for (auto c : c1)
cout << " " << c;
cout << endl;
Iter = c1.begin();
Iter++;
c1.insert(Iter, 100);
cout << "c1 =";
for (auto c : c1)
cout << " " << c;
cout << endl;
Iter = c1.begin();
Iter++;
Iter++;
c1.insert(Iter, 2, 200);
cout << "c1 =";
for(auto c : c1)
cout << " " << c;
cout << endl;
c1.insert(++c1.begin(), c2.begin(), --c2.end());
cout << "c1 =";
for (auto c : c1)
cout << " " << c;
cout << endl;
// initialize a list of strings by moving
list < string > c3;
string str("a");
c3.insert(c3.begin(), move(str));
cout << "Moved first element: " << c3.front() << endl;
// Assign with an initializer_list
list <int> c4{ {1, 2, 3, 4} };
c4.insert(c4.begin(), { 5, 6, 7, 8 });
cout << "c4 =";
for (auto c : c4)
cout << " " << c;
cout << endl;
}
出力
c1 = 10 20 30c1 = 10 100 20 30c1 = 10 100 200 200 20 30c1 = 10 40 50 100 200 200 20 30Moved first element: ac4 = 5 6 7 8 1 2 3 4
必要条件
ヘッダー: <list>
名前空間: std