multiset::insert
多重セットに要素または要素範囲を挿入します。
iterator insert(
const value_type& _Val
);
iterator insert(
const_iterator _Where,
const value_type& _Val
);
template<class InputIterator>
void insert(
InputIterator _First,
InputIterator _Last
);
template<class ValTy>
iterator insert(
ValTy&& val
);
template<class ValTy>
iterator insert(
const_iterator _Where,
ValTy&& _Val
);
パラメーター
パラメーター |
説明 |
_Val |
多重セットが既にその要素をか、キーが同じで並べる要素をよりよくある場合、セットに挿入する要素の値。 |
_Where |
挿入の正しいポイントの検索を開始する位置。挿入は対数の時間ではなく償却定数時間で挿入位置がの _Whereに従う必要が生じることがあります。 |
_First |
多重セットからコピーする最初の要素の位置。 |
_Last |
多重セットからコピーする最後の要素を越える位置だけ。 |
戻り値
insert のメンバー関数は新しい要素が複数セットに挿入位置を指す反復子。
解説
3 番目のメンバー関数は、指定された複数の範囲 [_First、_Last) の反復子によってアドレス各要素に対応する複数のセットに要素値のシーケンスを挿入します。
最後の 2 つのメンバー関数は、先頭の 2 つのメンバー関数と同じように動作しますが、挿入値を作成するのに val が使用される点が異なります。
使用例
// multiset_insert.cpp
// compile with: /EHsc
#include <set>
#include <iostream>
#include <string>
int main( )
{
using namespace std;
multiset <int>::iterator ms1_pIter, ms2_pIter;
multiset <int, less<int> > ms1, ms2;
ms1.insert( 10 );
ms1.insert( 20 );
ms1.insert( 30 );
ms1.insert( 40 );
cout << "The original ms1 =";
for ( ms1_pIter = ms1.begin( ); ms1_pIter != ms1.end( ); ms1_pIter++ )
cout << " " << *ms1_pIter;
cout << "." << endl;
ms1.insert( 20 );
ms1.insert( --ms1.end( ), 50 );
cout << "After the insertions, ms1 =";
for ( ms1_pIter = ms1.begin( ); ms1_pIter != ms1.end( ); ms1_pIter++ )
cout << " " << *ms1_pIter;
cout << "." << endl;
ms2.insert( 100 );
ms2.insert( ++ms1.begin( ), --ms1.end( ) );
cout << "ms2 =";
for ( ms2_pIter = ms2.begin( ); ms2_pIter != ms2.end( ); ms2_pIter++ )
cout << " " << *ms2_pIter;
cout << "." << endl;
// Construct by moving
multiset<string> ms3, ms4;
string str1("a"), str2("b");
ms3.insert(move(str1));
cout << "After the move insertion, ms3 contains: "
<< *ms3.begin() << endl;
ms4.insert(ms4.begin(), move(str2));
cout << "After the move insertion, ms4 contains: "
<< *ms4.begin() << endl;
}
必要条件
ヘッダー: <set>
名前空間: std