std::list<T,Allocator>::emplace_front

< cpp‎ | container‎ | list

template< class... Args >
void emplace_front( Args&&... args );
(C++11 起)
(C++17 前)
template< class... Args >
reference emplace_front( Args&&... args );
(C++17 起)

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

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

参数

args - 转发给元素构造函数的参数
类型要求
-
T (容器元素类型) 必须满足可就位构造 (EmplaceConstructible) 的要求。

返回值

(无) (C++17 前)
到被插入元素的引用。 (C++17 起)

复杂度

常数。

异常

若抛异常,则此函数无效果(强异常保证)。

参阅

插入元素到容器起始
(公开成员函数)