std::list::emplace

来自cppreference.com
< cpp‎ | container‎ | list
template< class... Args >
iterator emplace( const_iterator pos, Args&&... args );
(C++11 起)

直接于 pos 前插入元素到容器中。通过 std::allocator_traits::construct 构造元素,它典型地用布置 new 在容器所提供的位置原位构造元素。将参数 args... 作为 std::forward<Args>(args)... 转发给构造函数。

没有引用和迭代器被非法化。

目录

[编辑] 参数

pos - 将构造新元素到其前的迭代器
args - 转发给元素构造函数的参数
类型要求
-
T (容器元素类型) 必须满足 EmplaceConstructible 的要求。

[编辑] 返回值

指向被安置的元素的迭代器。

[编辑] 复杂度

常数。

[编辑] 异常

若抛异常(例如由构造函数),则保留容器不修改,如同未曾调用过此函数(强异常保证)。


[编辑] 参阅

插入元素
(公开成员函数) [编辑]