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

template < class ... Args > iterator emplace ( Args && ... args ) ;		(自 C++11 起) (自 C++26 起为 constexpr)

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

新元素的构造函数将以与传递给 emplace 完全相同的参数被调用，这些参数通过 std:: forward < Args > ( args ) ... 进行转发。

如果 value_type 不能通过 args 置入构造到 unordered_multiset 中，则行为未定义。

如果在操作后新元素数量大于原 max_load_factor() * bucket_count() 将发生重新哈希。
若发生重新哈希（因插入操作导致），所有迭代器将失效。否则（未发生重新哈希），迭代器保持有效。

目录 1 参数 2 返回值 3 异常 4 复杂度 5 备注 6 示例 7 另请参阅

参数

args

-

要转发给元素构造函数的参数

返回值

指向被插入元素的迭代器。

异常

若因任何原因抛出异常，此函数不产生任何效果（ 强异常安全保证 ）。

复杂度

平均情况下摊销常数复杂度，最坏情况与容器大小呈线性关系。

注释

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

示例

本节内容不完整 原因：缺少示例

参见

emplace_hint	使用提示原位构造元素 (公开成员函数)
insert	插入元素 或节点 (C++17 起) (公开成员函数)