Namespaces
Variants

std::flat_map<Key,T,Compare,KeyContainer,MappedContainer>:: insert_or_assign

From cppreference.net
C++
Containers library
std::flat_map
Member types
Member functions
Non-member functions
Helper classes
Tags
Deduction guides
template < class M >
std:: pair < iterator, bool > insert_or_assign ( const key_type & k, M && obj ) ;
(1) (C++23以降)
template < class M >
std:: pair < iterator, bool > insert_or_assign ( key_type && k, M && obj ) ;
(2) (C++23以降)
template < class K, class M >
std:: pair < iterator, bool > insert_or_assign ( K && k, M && obj ) ;
(3) (C++23以降)
template < class M >
iterator insert_or_assign ( const_iterator hint, const key_type & k, M && obj ) ;
(4) (C++23以降)
template < class M >
iterator insert_or_assign ( const_iterator hint, key_type && k, M && obj ) ;
(5) (C++23以降)
template < class K, class M >
iterator insert_or_assign ( const_iterator hint, K && k, M && obj ) ;
(6) (C++23以降)
1,2) コンテナ内にキー k と等価なキーが既に存在する場合、 std:: forward < M > ( obj ) をキー k に対応する mapped_type に代入する。キーが存在しない場合は、以下のように新しい値を挿入する：
プログラムは、 std:: is_assignable_v < mapped_type & , M > または std:: is_constructible_v < mapped_type, M > のいずれかが false である場合、不適格です。
3,6) コンテナ内にキー k と等価なキーが既に存在する場合、 std:: forward < M > ( obj ) をキー k に対応する mapped_type に代入する。それ以外の場合は以下と等価：
k から key_type への変換は、オブジェクト u を構築しなければならず、そのオブジェクトに対して find ( k ) == find ( u ) が true でなければならない。そうでない場合、動作は未定義となる。
これらのオーバーロードは、以下の条件を満たす場合にのみオーバーロード解決に参加します：
イテレータの無効化に関する情報は こちら からコピーされています

目次

パラメータ

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

戻り値

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

計算量

1-3) emplace と同様。
4-6) emplace_hint の場合と同様。

注記

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

例

このコードを実行 
#include <flat_map>
#include <iostream>
#include <string>
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::flat_map<std::string, std::string> map;
    print_result(map.insert_or_assign("a", "apple"));
    print_result(map.insert_or_assign("b", "banana"));
    print_result(map.insert_or_assign("c", "cherry"));
    print_result(map.insert_or_assign("c", "clementine"));
    for (const auto& node : map)
        print_node(node);
}

出力: 

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

関連項目

指定された要素にアクセスまたは挿入
(公開メンバ関数)
境界チェック付きで指定された要素にアクセス
(公開メンバ関数)
要素を挿入
(公開メンバ関数)
要素をその場で構築
(公開メンバ関数)
キーが存在しない場合はその場で挿入、キーが存在する場合は何もしない
(公開メンバ関数)