Namespaces
Variants

std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: insert_or_assign

From cppreference.net

C++
Containers library
std::unordered_map
Member types
Member functions
Non-member functions
Deduction guides (C++17)
template < class M >
std:: pair < iterator, bool > insert_or_assign ( const Key & k, M && obj ) ;
(1) (C++17以降)
template < class M >
std:: pair < iterator, bool > insert_or_assign ( Key && k, M && obj ) ;
(2) (C++17以降)
template < class K, class M >
std:: pair < iterator, bool > insert_or_assign ( K && k, M && obj ) ;
(3) (C++26以降)
template < class M >
iterator insert_or_assign ( const_iterator hint, const Key & k, M && obj ) ;
(4) (C++17以降)
template < class M >
iterator insert_or_assign ( const_iterator hint, Key && k, M && obj ) ;
(5) (C++17以降)
template < class K, class M >
iterator insert_or_assign ( const_iterator hint, K && k, M && obj ) ;
(6) (C++26以降)
1,4) コンテナ内に既に k と等価なキーが存在する場合、 std:: forward < M > ( obj ) をキー k に対応する mapped_type に代入する。キーが存在しない場合は、 insert と同様に新しい値を挿入し、それを value_type ( k, std:: forward < M > ( obj ) ) から構築する。
2,5) (1,4) と同じですが、マップされた値は value_type ( std :: move ( k ) , std:: forward < M > ( obj ) ) から構築されます。
3,6) コンテナ内にキー k と等価なキーが既に存在する場合、 mapped_type に対応する値に std:: forward < M > ( obj ) を代入する。キーが存在しない場合、 value_type のオブジェクト u を std:: forward < K > ( k ) , std:: forward < M > ( obj ) ) で構築し、 u を * this に挿入する。 hash_function ( ) ( u. first ) ! = hash_function ( ) ( k ) || contains ( u. first ) が true の場合、動作は未定義である。 value_type は EmplaceConstructible でなければならず、 std:: forward < K > ( k ) , std:: forward < M > ( obj ) から unordered_map へ構築可能でなければならない。このオーバーロードは、 Hash と KeyEqual の両方が transparent である場合にのみオーバーロード解決に参加する。これは、そのような Hash が K と Key 型の両方で呼び出し可能であり、 KeyEqual がtransparentであることを前提としており、これらにより Key のインスタンスを構築せずにこの関数を呼び出すことができる。

動作は未定義 (C++20まで) プログラムは不適格 (C++20以降) もし std:: is_assignable_v < mapped_type & , M && > が false の場合。

操作後に新しい要素数が元の max_load_factor() * bucket_count() より大きい場合、再ハッシュが行われます。
再ハッシュが発生した場合（挿入による）、すべてのイテレータは無効化されます。それ以外の場合（再ハッシュなし）、イテレータは無効化されません。

目次

パラメータ

k - 検索に使用され、見つからない場合は挿入にも使用されるキー
hint - 新しい要素が挿入される位置の直前を指すイテレータ
obj - 挿入または代入する値

戻り値

1-3) bool コンポーネントは、挿入が行われた場合は true となり、代入が行われた場合は false となります。イテレータコンポーネントは、挿入または更新された要素を指しています。
4-6) 挿入または更新された要素を指すイテレータ。

計算量

1-3) emplace と同様。
4-6) emplace_hint と同じ。

注記

insert_or_assign は operator [ ] よりも多くの情報を返し、マップ型のデフォルト構築可能性を必要としません。

機能テスト マクロ 値 標準 機能
__cpp_lib_unordered_map_try_emplace 201411L (C++17) std::unordered_map::try_emplace ,
std::unordered_map::insert_or_assign
__cpp_lib_associative_heterogeneous_insertion 202311L (C++26) 順序付きおよび非順序連想 コンテナ の残りのメンバー関数に対する異種型オーバーロード。 ( 3 ) および ( 6 ) のオーバーロード。

例

このコードを実行 
#include <iostream>
#include <string>
#include <unordered_map>
void print_node(const auto& node)
{
    std::cout << '[' << node.first << "] = " << node.second << '\n';
}
void print_result(auto const& pair)
{
    std::cout << (pair.second ? "inserted: " : "assigned: ");
    print_node(*pair.first);
}
int main()
{
    std::unordered_map<std::string, std::string> myMap;
    print_result(myMap.insert_or_assign("a", "apple"));
    print_result(myMap.insert_or_assign("b", "banana"));
    print_result(myMap.insert_or_assign("c", "cherry"));
    print_result(myMap.insert_or_assign("c", "clementine"));
    for (const auto& node : myMap)
        print_node(node);
}

出力例: 

inserted: [a] = apple
inserted: [b] = banana
inserted: [c] = cherry
assigned: [c] = clementine
[c] = clementine
[a] = apple
[b] = banana

関連項目

指定された要素にアクセスまたは挿入する
(public member function)
境界チェック付きで指定された要素にアクセスする
(public member function)
要素を挿入する またはノード (C++17以降)
(public member function)
要素をその場で構築する
(public member function)