std::flat_set<Key,Compare,KeyContainer>::emplace
来自 cppreference.com
template< class... Args > std::pair<iterator, bool> emplace( Args&&... args ); |
(自 C++23) | |
如果容器中没有具有该键的元素,则使用给定的 args 在容器中就地构造一个新元素并将其插入容器中。
首先,使用 std::forward<Args>(args)... 初始化类型为value_type
的对象 t,然后像下面这样插入 t:auto it = ranges::upper_bound(c, t, compare); c.insert(it, std::move(t));
只有当 std::is_constructible_v<value_type, Args...> 为 true 时,此重载才参与重载解析。
谨慎使用 emplace
允许在构造新元素时避免不必要的复制或移动操作。
有关迭代器失效的信息已从 此处 复制。 |
内容 |
[编辑] 参数
args | - | 要转发给元素构造函数的参数 |
[编辑] 返回值
一个包含指向已插入元素(或阻止插入的元素)的迭代器和一个 bool 值的 pair,该值当且仅当插入成功时设置为 true。
[编辑] 异常
如果由于任何原因抛出异常,则此函数无效(强异常安全性保证)。
[编辑] 复杂度
容器大小的对数。
[编辑] 示例
本节尚未完善 原因:没有示例 |
[编辑] 另请参见
使用提示就地构造元素 (公共成员函数) | |
插入元素 (公共成员函数) |