C++官网参考链接:https://cplusplus.com/reference/deque/deque/emplace_front/
公有成员函数
<deque>
std::deque::emplace_front
template <class... Args> void emplace_front (Args&&... args);
在开始处构造并插入元素
在deque的开始处插入一个新元素,就在它当前的第一个元素之前。这个新元素是使用args作为构造它的实参来就地构造的。
这有效地将容器的size增加了1。
元素是通过使用转发的args调用allocator_traits::construct就地构造的。
存在一个类似的成员函数push_front,它将现有对象复制或移动到容器中。
形参
args
用来构造新元素而转发的实参。
返回值
没有返回值。
新元素的存储是使用allocator_traits<allocator_type>::construct()分配的,它可能在失败时抛出异常(对于默认的allocator,如果分配请求不成功,则抛出bad_alloc)。
用例
// deque::emplace_from
#include <iostream>
#include <deque>
int main ()
{
std::deque<int> mydeque = {10,20,30};
mydeque.emplace_front (111);
mydeque.emplace_front (222);
std::cout << "mydeque contains:";
for (auto& x: mydeque)
std::cout << ' ' << x;
std::cout << '\n';
return 0;
}
输出:
复杂度
常量。
iterator的有效性
与此容器相关的所有iterator都无效,但指针和reference仍然有效,指向调用之前所引用的相同元素。
数据竞争
完成容器的修改。
调用不会访问任何包含的元素:同时访问或修改它们是安全的(请参阅上面的iterator的有效性)。
异常安全
强保证:如果抛出异常,则容器中不会有任何更改。
如果适当的实参不支持allocator_traits::construct,则会导致未定义的行为。