命名空间
变体
操作

std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::emplace

来自 cppreference.cn
 
 
 
 
template< class... Args >
iterator emplace( Args&&... args );
(自 C++11 起)

使用给定的 args 就地构造一个新的元素并将其插入到容器中。

新元素的构造函数被调用时,会使用与提供给 emplace 的参数完全相同的参数,这些参数通过 std::forward<Args>(args)... 转发。

谨慎使用 emplace 可以允许在构造新元素的同时避免不必要的复制或移动操作。

如果在操作之后,新元素的数量大于旧的 max_load_factor() * bucket_count(),则会发生重哈希。
如果发生重哈希(由于插入),则所有迭代器都会失效。否则(不重哈希),迭代器不会失效。

内容

[编辑] 参数

args - 转发给元素构造函数的参数

[编辑] 返回值

指向插入元素的迭代器。

[编辑] 异常

如果由于任何原因抛出异常,此函数不起作用(强异常安全保证)。

[编辑] 复杂度

平均摊销常数时间复杂度,最坏情况为容器大小的线性时间复杂度。

[编辑] 示例

[编辑] 参见

使用提示就地构造元素
(公共成员函数) [编辑]
插入元素 或节点(自 C++17 起)
(公共成员函数) [编辑]