multimap::emplace_hint
インプレースで構築された (コピーまたは移動操作が実行されない) 要素を、配置ヒントと一緒に挿入します。
template<class... Args>
iterator emplace_hint(
const_iterator where,
Args&&... args);
パラメーター
パラメーター |
説明 |
args |
multimap に挿入される要素を構築するために転送される引数。 |
where |
正しい挿入ポイントの検索を開始する場所 (その位置が where の直前にある場合、挿入処理は対数時間ではなく償却定数時間で実行できます)。 |
戻り値
新しく挿入される要素を指す反復子。
解説
この関数では、コンテナー要素を指す参照は無効になりません。ただし、コンテナーを指すすべての反復子が無効になる場合があります。
配置の実行中、例外がスローされるとコンテナーの状態は変更されません。
要素の value_type はペアを表します。これにより、要素の値は順序付けされたペアになり、このペアの最初のコンポーネントはキー値と同じで、2 番目のコンポーネントは要素のデータ値と同じになります。
コード例については、「map::emplace_hint」を参照してください。
必要条件
ヘッダー: <map>
名前空間: std