unordered_map::emplace_hint
インプレースで構築された (コピーまたは移動操作が実行されない) 要素を、配置ヒントと一緒に挿入します。
template<class... Args>
iterator emplace_hint(
const_iterator where,
Args&&... args);
パラメーター
パラメーター |
説明 |
args |
挿入される要素が unordered_map にまだ含まれていない場合、一般的には、キーが同じ順序付けになる要素が unordered_map にまだ含まれていない場合に、unordered_map に挿入される要素を構築するために転送される引数。 |
where |
正しい挿入ポイントの検索を開始する場所に関するヒント。 |
戻り値
新しく挿入される要素を指す反復子。
要素が既に存在するために挿入が失敗した場合は、既存の要素を指す反復子を返します。
解説
この関数では、参照は無効になりません。
挿入時、例外がスローされたが、コンテナーのハッシュ関数ではエラーが発生しなかった場合、コンテナーは変更されません。 ハッシュ関数で例外がスローされた場合、結果は未定義になります。
要素の value_type はペアを表します。これにより、要素の値は順序付けされたペアになり、このペアの最初のコンポーネントはキー値と同じで、2 番目のコンポーネントは要素のデータ値と同じになります。
コード例については、「map::emplace_hint」を参照してください。
必要条件
ヘッダー: <unordered_map>
名前空間: std