std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>:: emplace_hint
|
template
<
class
...
Args
>
iterator emplace_hint ( const_iterator hint, Args && ... args ) ; |
(C++11以降)
(constexpr C++26以降) |
|
コンテナに新しい要素を挿入します。 hint を挿入位置の提案として使用します。
value_typeのコンストラクタ（すなわち、
std::
pair
<
const
Key, T
>
）は、関数に供給された引数と全く同じ引数で呼び出され、
std::
forward
<
Args
>
(
args
)
...
によって転送されます。
操作後に新しい要素数が元の
max_load_factor()
*
bucket_count()
より大きい場合、再ハッシュが行われます。
再ハッシュが発生した場合（挿入による）、すべてのイテレータは無効化されます。それ以外の場合（再ハッシュなし）、イテレータは無効化されません。
目次 |
パラメータ
| hint | - | イテレータ、新しい要素を挿入する位置の提案として使用 |
| args | - | 要素のコンストラクタに転送する引数 |
戻り値
挿入された要素へのイテレータ。
例外
何らかの理由で例外がスローされた場合、この関数は何も効果を持ちません（ strong exception safety guarantee ）。
計算量
償却計算では平均的に定数時間、最悪ケースではコンテナのサイズに対して線形時間。
例
|
このセクションは不完全です
理由: 例がありません |
関連項目
|
要素をその場で構築する
(公開メンバ関数) |
|
|
要素を挿入する
またはノード
(C++17以降)
(公開メンバ関数) |