std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::emplace
從 cppreference.com
< cpp | container | unordered map
| template< class... Args > std::pair<iterator, bool> emplace( Args&&... args ); |
(C++11 起) | |
若容器中沒有擁有該鍵的元素，則向容器插入以給定的 args 原位構造的新元素。
以與提供給 emplace 嚴格相同的實參，通過 std::forward<Args>(args)... 轉發，調用新元素（即 std::pair<const Key, T>）的構造函數。
即使容器中已有擁有該關鍵的元素，也可能構造元素，該情況下新構造的元素將被立即銷毀（若不想要此行為，請參見 try_emplace()）。
細心地使用 emplace 允許在構造新元素的同時避免不必要的複製或移動操作。
如果操作後新的元素數量大於原 max_load_factor() * bucket_count() 則會發生重散列。
如果（因插入而）發生了重散列，所有迭代器均會失效。否則（未發生重散列），則迭代器不會失效。
目錄 |
[編輯] 參數
| args | - | 要轉發給元素構造函數的實參 |
[編輯] 返回值
由一個指向被插入元素（或指向妨礙插入的元素）的迭代器和一個當且僅當發生插入時被設為 true 的 bool 值構成的對偶。
[編輯] 異常
如果因為任何原因拋出了異常，那麼此函數無效果（強異常安全保證）。
[編輯] 複雜度
平均為均攤常數，最壞情況與容器大小成線性。
[編輯] 示例
運行此代碼
#include <iostream> #include <string> #include <utility> #include <unordered_map> int main() { std::unordered_map<std::string, std::string> m; // 使用 pair 的移动构造函数 m.emplace(std::make_pair(std::string("a"), std::string("a"))); // 使用 pair 的转换移动构造函数 m.emplace(std::make_pair("b", "abcd")); // 使用 pair 的模板构造函数 m.emplace("d", "ddd"); // 带有重复键的 emplace 没有效果 m.emplace("d", "DDD"); // 使用 pair 的逐段构造函数 m.emplace(std::piecewise_construct, std::forward_as_tuple("c"), std::forward_as_tuple(10, 'c')); // 一种替代方案是：m.try_emplace("c", 10, 'c'); for (const auto& p : m) std::cout << p.first << " => " << p.second << '\n'; }
可能的輸出：
a => a b => abcd c => cccccccccc d => ddd
[編輯] 參閱
| 使用提示原位構造元素 (公開成員函數) | |
| (C++17) |
若鍵不存在則原位插入，若鍵存在則不做任何事 (公開成員函數) |
| 插入元素或節點(C++17 起) (公開成員函數) |
