std::
unordered_multiset::emplace_hint
公众成员函数 <unordered_set>
template <class... Args>
iterator emplace_hint (const_iterator position, Args&&... args);
构造插入元素并加提示
在
unordered_multiset中插入一个新元素。
这个新元素是使用
args作为元素构造函数的参数构造。
Position指向容器中的一个位置,提示从哪里开始搜索其插入点(容器可能使用也可能不使用此建议来优化插入操作)。
存在一个类似的成员函数
insert,它将现有对象复制或移动到容器中,也可以获取位置提示。
☲ 参数
-
position
-
作为插入操作提示的位置。容器可以使用该值来优化操作。
成员类型const_iterator是前向迭代器类型。
-
args
-
传递给要插入的新元素的构造函数的参数。
☉ 返回值
返回插入元素的迭代器。
成员类型
iterator是前向迭代器类型。
unordered_multiset容器中的所有迭代器都具有对元素的
const访问权限:元素可以插入或移除,但不能在容器中修改。
使用
allocator_traits<allocator_type>::construct()分配新元素的存储,
失败时可能抛出异常(对于默认分配器,如果分配请求不成功则抛出
bad_alloc)。
☣ 示例
参阅 unordered_multiset::emplace。
✥ 复杂度
平均情况下:常数。
最坏情况:容器大小呈线性。
可能会触发重新
hash(不包括)。
☣ 迭代器的有效性
在大多数情况下,容器中的所有迭代器在插入之后仍然有效。唯一的例外是容器的增长迫使重新hash。
在这种情况下,容器中的所有迭代器都失效。
如果插入操作后的新容器大小超过其容量阈值(计算方法为容器的
bucket_count乘以其
max_load_factor),
则强制进行
rehash。
引用在所有情况下都保持有效,即使在
rehash之后也是如此。
🍄 另请参阅
unordered_multiset::emplace |
构造插入元素(公众成员函数) |
unordered_multiset::insert |
插入元素(公众成员函数) |