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

コンテナにキー k と同等のキーが既に存在する場合、何も行いません。それ以外の場合、キー k と args で構築された値を持つ新しい要素をコンテナに挿入します。この場合：

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

パラメータ

戻り値

計算量

注記

insert や emplace とは異なり、これらの関数は挿入が発生しない場合に右辺値引数からのムーブを行いません。これにより、 std:: unordered_map < std:: string , std:: unique_ptr < foo >> のように値がムーブのみ可能な型のマップを操作するのが容易になります。さらに、 try_emplace はキーと mapped_type への引数を個別に扱いますが、これは emplace が value_type （つまり std::pair ）を構築するための引数を必要とするのとは異なります。

オーバーロード ( 3 ) および ( 6 ) は、 Key 型のオブジェクトを構築せずに呼び出すことができます。

例

#include <iostream>
#include <string>
#include <unordered_map>
#include <utility>
void print_node(const auto& node)
{
    std::cout << '[' << node.first << "] = " << node.second << '\n';
}
void print_result(auto const& pair)
{
    std::cout << (pair.second ? "inserted: " : "ignored:  ");
    print_node(*pair.first);
}
int main()
{
    using namespace std::literals;
    std::unordered_map<std::string, std::string> m;
    print_result(m.try_emplace("a", "a"s));
    print_result(m.try_emplace("b", "abcd"));
    print_result(m.try_emplace("c", 10, 'c'));
    print_result(m.try_emplace("c", "Won't be inserted"));
    for (const auto& p : m)
        print_node(p);
}

inserted: [a] = a
inserted: [b] = abcd
inserted: [c] = cccccccccc
ignored:  [c] = cccccccccc
[a] = a
[b] = abcd
[c] = cccccccccc

関連項目