public member function
<list>

std::list::emplace

template <class... Args>  iterator emplace (const_iterator position, Args&&... args);
构造并插入元素
通过在position处插入一个新元素来扩展容器。此新元素使用args作为其构造函数的参数就地构造。

这会使容器的 size 有效地增加一。

与其他标准序列容器不同,listforward_list容器专门设计用于在任何位置(即使在序列中间)高效地插入和删除元素。

通过调用allocator_traits::construct并转发args来就地构造元素。

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

参数

position
新元素插入到容器中的位置。
成员类型const_iterator是一个指向 const 元素的双向迭代器类型。
args
转发给构造新元素的参数。

返回值

指向新插入元素的迭代器。

成员类型iterator是指向元素的双向迭代器类型。

新元素的存储使用容器的 allocator 分配,分配失败时可能会抛出异常(对于默认 allocatorbad_alloc如果分配请求不成功,则抛出)。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// list::emplace
#include <iostream>
#include <list>

int main ()
{
  std::list< std::pair<int,char> > mylist;

  mylist.emplace ( mylist.begin(), 100, 'x' );
  mylist.emplace ( mylist.begin(), 200, 'y' );

  std::cout << "mylist contains:";
  for (auto& x: mylist)
    std::cout << " (" << x.first << "," << x.second << ")";

  std::cout << '\n';
  return 0;
}
输出
mylist contains: (200,y) (100,x)


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

容器已被修改。
没有访问容器中的元素:并发访问或修改它们是安全的,尽管迭代包含position的范围则不然。

异常安全

强保证:如果抛出异常,容器没有发生变化。
如果不支持具有适当参数的 allocator_traits::construct,或者 position 无效,则会导致未定义行为

另见