hash_multimap::insert
[!メモ]
この API は、互換性のために残されています。代わりに unordered_multimap クラスです。
hash_multimapに要素または要素範囲を挿入します。
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 |
hash_multimapが既にその要素をか、キーが同じで並べる要素をよりよくある場合hash_multimapに挿入する要素の値。 |
_Where |
挿入の正しいポイントの検索を開始する場所に関するヒント。 |
_First |
マップからコピーする最初の要素の位置。 |
_Last |
マップからコピーする最後の要素を越える位置だけ。 |
戻り値
最初の2 insert のメンバー関数は新しい要素が挿入された位置を指す反復子。
最後の2回の insert のメンバー関数は最初の2と同じように動作しますが、構成要素値を挿入します。
解説
要素の value_type は、要素の値がキー値と等しい最初の構成要素および要素のデータ値と等しい2番目のコンポーネントとの順序付けられたペアになるように、ペアです。
挿入は対数の時間ではなく、挿入のツールヒントのバージョンの経費償却定数時間で挿入位置がの _Whereする場合は、発生することがあります。
3番目のメンバー関数は、指定されたセットの範囲 [_First、_Last) の反復子によってアドレス各要素に対応するマップに要素値のシーケンスを挿入します。
使用例
// hash_multimap_insert.cpp
// compile with: /EHsc
#include <hash_map>
#include <iostream>
#include <string>
int main( )
{
using namespace std;
using namespace stdext;
hash_multimap <int, int>::iterator hm1_pIter, hm2_pIter;
hash_multimap <int, int> hm1, hm2;
typedef pair <int, int> Int_Pair;
hm1.insert ( Int_Pair ( 1, 10 ) );
hm1.insert ( Int_Pair ( 2, 20 ) );
hm1.insert ( Int_Pair ( 3, 30 ) );
cout << "The original key values of hm1 =";
for ( hm1_pIter = hm1.begin( ); hm1_pIter != hm1.end( );
hm1_pIter++ )
cout << " " << hm1_pIter -> first;
cout << "." << endl;
cout << "The original mapped values of hm1 =";
for ( hm1_pIter = hm1.begin( ); hm1_pIter != hm1.end( );
hm1_pIter++ )
cout << " " << hm1_pIter -> second;
cout << "." << endl;
hm1.insert ( Int_Pair ( 1, 10 ) );
// The hint version of insert
hm1.insert( --hm1.end( ), Int_Pair ( 4, 40 ) );
cout << "After the insertions, the key values of hm1 =";
for ( hm1_pIter = hm1.begin( ); hm1_pIter != hm1.end( );
hm1_pIter++ )
cout << " " << hm1_pIter -> first;
cout << "," << endl;
cout << " and the mapped values of hm1 =";
for ( hm1_pIter = hm1.begin( ); hm1_pIter != hm1.end( );
hm1_pIter++ )
cout << " " << hm1_pIter -> second;
cout << "." << endl;
hm2.insert ( Int_Pair ( 10, 100 ) );
// The templatized version inserting a range
hm2.insert( ++hm1.begin( ), --hm1.end( ) );
cout << "After the insertions, the key values of hm2 =";
for ( hm2_pIter = hm2.begin( ); hm2_pIter != hm2.end( );
hm2_pIter++ )
cout << " " << hm2_pIter -> first;
cout << "," << endl;
cout << " and the mapped values of hm2 =";
for ( hm2_pIter = hm2.begin( ); hm2_pIter != hm2.end( );
hm2_pIter++ )
cout << " " << hm2_pIter -> second;
cout << "." << endl;
// The templatized versions move constructing elements
hash_multimap<int, string> hm3, hm4;
pair<int, string> is1(1, "a"), is2(2, "b");
hm3.insert(move(is1));
cout << "After the move insertion, hm3 contains:" << endl
<< " " << hm3.begin()->first
<< " => " << hm3.begin()->second
<< endl;
hm4.insert(hm4.begin(), move(is2));
cout << "After the move insertion, hm4 contains:" << endl
<< " " << hm4.begin()->first
<< " => " << hm4.begin()->second
<< endl;
}
必要条件
ヘッダー: <hash_map>
名前空間: のstdext