std::deque::emplace

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

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

所有迭代器,含尾后迭代器,都被非法化。引用亦被非法化,除非 pos == begin()pos == end() ,该情况下它们不被非法化。

目录

[编辑] 参数

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

[编辑] 返回值

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

[编辑] 复杂度

pos 和容器两端距离的较小者成线性。

[编辑] 异常

若 value_type 的复制构造函数、移动构造函数、赋值运算符或移动赋值运算符以外的操作抛异常,或若在用 emplace 在任一端插入单个元素时抛异常,则无效果(强异常保证)。

否则,效果未指定。


[编辑] 参阅

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