deque::emplace_back-c和c++中文资料站

C&C++标准库

std::

deque::emplace_back

公众成员函数 <deque>

template <class... Args>
  void emplace_back (Args&&... args);

构造并在末尾插入元素
在deque容器的末尾插入一个新元素，就在当前最后一个元素的后面。这个新元素使用args作为其构造的参数构造。

容器大小加1.

元素是通过调用allocator_traits::construct和转发的参数构造的。

存在一个类似的成员函数push_back，它将现有对象复制或移动到容器中。

☲ 参数

args: 为构造新元素而传递的参数。

☉ 返回值

none
新元素的存储是使用allocator_traits<allocator_type>::construct()分配的，如果失败，可能会抛出异常(对于默认的分配器，如果分配请求不成功，会抛出bad_alloc)。

☣ 示例

// deque::emplace_from
#include <iostream>
#include <deque>

int main ()
{
  std::deque<int> mydeque = {10,20,30};

  mydeque.emplace_back (100);
  mydeque.emplace_back (200);

  std::cout << "mydeque contains:";
  for (auto& x: mydeque)
    std::cout << ' ' << x;
  std::cout << '\n';

  return 0;
}

输出:
mydeque contains: 10 20 30 100 200

✥ 复杂度

常量

☣ 迭代器的有效性

与该容器相关的所有迭代器都失效，但指针和引用仍然有效，它们引用的元素与调用前相同。

⇄ 数据竞争

容器被修改。
调用不会访问所包含的元素:并发访问或修改它们是安全的(请参阅上面的迭代器有效性)。

☂ 异常安全性

强保证:如果抛出异常，容器中没有任何变化。
如果不支持allocator_traits::construct，则会导致未定义的行为。

🍄 另请参阅

deque::erase	删除元素(公众成员函数)
deque::emplace	构造并插入元素 (公众成员函数)
deque::emplace_front	构造并在开头插入元素 (公众成员函数)
deque::assign	分配容器的内容 (公众成员函数)
deque::pop_back	删除最后一个元素 (公众成员函数)