std::unordered_multiset<Key,Hash,KeyEqual,Allocator>:: emplace_hint
|
(C++17)
|
||||
| Sequence | ||||
|
(C++11)
|
||||
|
(C++26)
|
||||
|
(C++26)
|
||||
|
(C++11)
|
||||
| Associative | ||||
| Unordered associative | ||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
| Adaptors | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
| Views | ||||
|
(C++20)
|
||||
|
(C++23)
|
||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
std::unordered_multiset
| Member types | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Non-member functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Deduction guides (C++17) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
template
<
class
...
Args
>
iterator emplace_hint ( const_iterator hint, Args && ... args ) ; |
(C++11 起)
(C++26 起为 constexpr) |
|
向容器中插入一个新元素，使用 hint 作为插入位置的参考建议。
键与映射值的构造函数会以与函数接收的完全相同的参数调用，这些参数通过 std:: forward < Args > ( args ) ... 进行完美转发。
如果在操作后新元素数量大于原
max_load_factor()
*
bucket_count()
的乘积，将发生重新哈希。
若发生重新哈希（因插入操作导致），所有迭代器将失效。否则（未发生重新哈希），迭代器保持有效。
目录 |
参数
| hint | - | 迭代器，作为插入新元素位置的参考提示 |
| args | - | 要转发给元素构造函数的参数 |
返回值
指向被插入元素的迭代器。
异常
若因任何原因抛出异常，此函数不产生任何效果（ 强异常安全保证 ）。
复杂度
平均情况下摊销常数复杂度，最坏情况与容器大小呈线性关系。
示例
|
本节内容不完整
原因：缺少示例 |
参见
|
原位构造元素
(公开成员函数) |
|
|
插入元素
或节点
(C++17 起)
(公开成员函数) |