std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::emplace
来自 cppreference.cn
< cpp | 容器 | unordered_multiset
template< class... Args > iterator emplace( Args&&... args ); |
(自 C++11 起) | |
使用给定的 args 就地构造一个新的元素并将其插入到容器中。
新元素的构造函数被调用时,会使用与提供给 emplace
的参数完全相同的参数,这些参数通过 std::forward<Args>(args)... 转发。
谨慎使用 emplace
可以允许在构造新元素的同时避免不必要的复制或移动操作。
如果在操作之后,新元素的数量大于旧的 max_load_factor()
*
bucket_count()
,则会发生重哈希。
如果发生重哈希(由于插入),则所有迭代器都会失效。否则(不重哈希),迭代器不会失效。
内容 |
[编辑] 参数
args | - | 转发给元素构造函数的参数 |
[编辑] 返回值
指向插入元素的迭代器。
[编辑] 异常
如果由于任何原因抛出异常,此函数不起作用(强异常安全保证)。
[编辑] 复杂度
平均摊销常数时间复杂度,最坏情况为容器大小的线性时间复杂度。
[编辑] 示例
本节不完整 原因:没有示例 |
[编辑] 参见
使用提示就地构造元素 (公共成员函数) | |
插入元素 或节点(自 C++17 起) (公共成员函数) |