名前空間
変種
操作

std::unordered_map::insert

提供: cppreference.com
 
 
 
 
std::pair<iterator,bool> insert( const value_type& value );
(1) (C++11およびそれ以降)
template< class P >
std::pair<iterator,bool> insert( P&& value );
(2) (C++11およびそれ以降)
std::pair<iterator,bool> insert( value_type&& value );
(2) (C++17およびそれ以降)
iterator insert( const_iterator hint, const value_type& value );
(3) (C++11およびそれ以降)
template< class P >
iterator insert( const_iterator hint, P&& value );
(4) (C++11およびそれ以降)
iterator insert( const_iterator hint, value_type&& value );
(4) (C++17およびそれ以降)
template< class InputIt >
void insert( InputIt first, InputIt last );
(5) (C++11およびそれ以降)
void insert( std::initializer_list<value_type> ilist );
(6) (C++11およびそれ以降)
insert_return_type insert(node_type&& nh);
(7) (C++17およびそれ以降)
iterator insert(const_iterator hint, node_type&& nh);
(8) (C++17およびそれ以降)

コンテナが同じキーの要素をまだ持っていない場合、要素をコンテナに挿入します。

1-2) value を挿入します。 オーバーロード (2)emplace(std::forward<P>(value)) と同等であり、 std::is_constructible<value_type, P&&>::value == true の場合にのみ、オーバーロード解決に参加します。
3-4) 検索を開始すべき位置の拘束力のない提案として hint を使用し、 value を挿入します。 オーバーロード (4)emplace_hint(hint, std::forward<P>(value)) と同等であり、 std::is_constructible<value_type, P&&>::value == true の場合にのみ、オーバーロード解決に参加します。
5) 範囲 [first, last) から要素を挿入します。 指定範囲内の複数の要素が等しいキーを持っている場合、どの要素が挿入されるかは未規定です (未解決の LWG2844)。
6) 初期化子リスト ilist から要素を挿入します。 指定範囲内の複数の要素が等しいキーを持っている場合、どの要素が挿入されるかは未規定です (未解決の LWG2844)。
7) nh が空のノードハンドルの場合は、何もしません。 そうでなければ、nh.key() と等しいキーを持つ要素がコンテナ内にすでに格納されていない場合、nh によって所有されている要素がコンテナに挿入されます。 nh が空でなく、 get_allocator() != nh.get_allocator() の場合、動作は未定義です。
8) nh が空のノードハンドルの場合は、何もせず、終端イテレータを返します。 そうでなければ、nh.key() と等しいキーを持つ要素がコンテナ内にすでに格納されていない場合、 nh によって所有されている要素をコンテナに挿入し、挿入が成功したか失敗したかに関わらず、 nh.key() と等しいキーを持つ要素を指すイテレータを返します。 挿入が成功すれば nh は移動され、そうでなければ要素の所有権は残ります。 要素は hint に可能な限り近い位置に挿入されます。 nh が空でなく、 get_allocator() != nh.get_allocator() の場合、動作は未定義です。

挿入によって再ハッシュが発生した場合は、すべてのイテレータが無効化されます。 そうでなければ、イテレータは影響を受けません。 参照は無効化されません。 再ハッシュは新しい要素数が max_load_factor()*bucket_count() より大きい場合にのみ発生します。 挿入が成功した場合、ノードハンドルに保持されている間に取得された要素へのポインタおよび参照は無効化され、抽出する前に取得された要素へのポインタおよび参照は有効なまま残されます。 (C++17およびそれ以降)

目次

[編集] 引数

hint - 内容の挿入位置の提案として使用されるイテレータ
value - 挿入する要素の値
first, last - 挿入する要素の範囲
ilist - 挿入する要素の初期化子リスト
nh - 互換性のあるノードハンドル
型の要件
-
InputItInputIterator の要件を満たさなければなりません。

[編集] 戻り値

1-2) 挿入された要素 (または挿入を妨げた要素) を指すイテレータと、挿入が行われたかどうかを表す bool から構成される、ペアを返します。
3-4) 挿入された要素 (または挿入を妨げた要素) を指すイテレータを返します。
5-6) (なし)
7) 以下のように初期化されたメンバを持つ insert_return_type が返されます。 nh が空の場合、 insertedfalse に、 positionend() に、 node は空に設定されます。 そうでなく、挿入が行われた場合、 insertedtrue に、 position は挿入された要素を指すように、 node は空に設定されます。 挿入が失敗した場合、 insertedfalse に、 nodenh の以前の値を持つように、 position は nh.key() と等しいキーを持つ要素を指すように設定されます。
8) nh が空の場合は終端イテレータ、挿入が行われた場合は挿入された要素を指すイテレータ、失敗した場合は nh.key() と等しいキーを持つ要素を指すイテレータ。

[編集] 例外

1-4) 何らかの操作によって例外が投げられた場合、挿入は効果を持ちません。

[編集] 計算量

1-4) 平均的なケース: O(1)、ワーストケース: O(size())
5-6) 平均的なケース: O(N)、ただし N は挿入する要素の数です。 ワーストケース: O(N*size()+N)
7-8) 平均的なケース: O(1)、ワーストケース: O(size())

[編集] ノート

ヒント付き挿入 (3,4) は、シーケンシャルコンテナの位置付き挿入 (std::vector::insert など) とのシグネチャ互換のため、ブーリアンを返しません。 これにより std::inserter のような汎用の挿入子の作成が可能となります。 ヒント付き挿入の成功を確認するひとつの方法は、挿入前後の size() を比較することです。

[編集]

#include <string>
#include <iostream>
#include <unordered_map>
 
int main ()
{
    std::unordered_map<int, std::string> dict = {{1, "one"}, {2, "two"}};
    dict.insert({3, "three"});
    dict.insert(std::make_pair(4, "four"));
    dict.insert({{4, "another four"}, {5, "five"}});
 
    bool ok = dict.insert({1, "another one"}).second;
    std::cout << "inserting 1 -> \"another one\" " 
              << (ok ? "succeeded" : "failed") << '\n';
 
    std::cout << "contents:\n";
    for(auto& p: dict)
        std::cout << " " << p.first << " => " << p.second << '\n';
}

出力例:

inserting 1 -> "another one" failed
contents:
 5 => five
 1 => one
 2 => two
 3 => three
 4 => four

[編集] 関連項目

要素をその場で構築します
(パブリックメンバ関数) [edit]
ヒントを使用して要素をその場で構築します
(パブリックメンバ関数) [edit]
要素を挿入します。 キーがすでに存在している場合は現在の要素に代入します
(パブリックメンバ関数) [edit]