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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

容器库

node-handle (C++17)

序列容器

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

关联容器

set

multiset

map

multimap

无序关联容器

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

容器适配器

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

视图

span (C++20)

mdspan (C++23)

表格

迭代器失效

成员函数表格

非成员函数表格

 

std::unordered_map

成员类型
成员函数
unordered_map::unordered_map unordered_map::~unordered_map unordered_map::operator= unordered_map::get_allocator 迭代器 unordered_map::beginunordered_map::cbegin unordered_map::endunordered_map::cend 容量 unordered_map::size unordered_map::max_size unordered_map::empty 修改器 unordered_map::clear unordered_map::erase unordered_map::swap unordered_map::extract (C++17) unordered_map::merge (C++17) unordered_map::insert unordered_map::insert_range (C++23) unordered_map::insert_or_assign (C++17)   unordered_map::emplace unordered_map::emplace_hint unordered_map::try_emplace (C++17)	查找 unordered_map::at unordered_map::operator[] unordered_map::count unordered_map::find unordered_map::contains (C++20) unordered_map::equal_range 桶接口 unordered_map::begin(size_type)unordered_map::cbegin(size_type) unordered_map::end(size_type)unordered_map::cend(size_type) unordered_map::bucket_count unordered_map::max_bucket_count unordered_map::bucket_size unordered_map::bucket 散列策略 unordered_map::load_factor unordered_map::max_load_factor unordered_map::rehash unordered_map::reserve 观察器 unordered_map::hash_function unordered_map::key_eq
非成员函数
operator==operator!= (C++20 前)	std::swap(std::unordered_map) erase_if(std::unordered_map) (C++20)
推导指引(C++17)

 

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(constauto& p : m)std::cout<< p.first<<" => "<< p.second<<'\n';}

可能的输出：

a => a b => abcd c => cccccccccc d => ddd

参阅

emplace_hint	使用提示原位构造元素 (公开成员函数)
try_emplace (C++17)	若键不存在则原位插入，若键存在则不做任何事 (公开成员函数)
insert	插入元素或节点(C++17 起) (公开成员函数)