C++官网参考链接:https://cplusplus.com/reference/list/list/emplace/
公有成员
<list>
std::list::emplace
template <class... Args> iterator emplace (const_iterator position, Args&&... args);
构造并插入元素
通过在position上插入一个新元素来扩展容器。这个新元素是使用args作为构造它的实参来就地构造的。
这有效地将容器的size增加了1。
与其他标准顺序容器不同,list和forward_list对象被专门设计为在任何位置(甚至在序列中间)高效插入和删除元素。
元素是通过使用转发的args调用allocator_traits::construct就地构造的。
存在一个类似的成员函数insert,它将现有对象复制或移动到容器中。
形参
position
插入新元素的容器中的位置。
成员类型const_iterator是指向const元素的双向iterator(bidirectional iterator)类型。
args
用来构造新元素而转发的实参。
返回值
指向新插入元素的iterator。
成员类型iterator是指向元素的双向iterator(bidirectional iterator)类型。
新元素的存储是使用容器的allocator分配的,这可能会在失败时抛出异常(对于默认allocator,如果分配请求不成功,则抛出bad_alloc)。
用例
// 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;
}
输出:
复杂度
常量。
iterator的有效性
没有变化。
数据竞争
完成容器的修改。
不访问包含的元素:同时访问或修改它们是安全的,但迭代包含position的范围就不安全了。
异常安全
强保证:如果抛出异常,则容器中不会有任何更改。
如果适当的实参不支持allocator_traits::construct,或者position无效,则会导致未定义的行为。