std::map::emplace_hint

参数

position

元素可插入位置的提示。
如果*position*指向将要插入元素的元素（或指向*end*，如果它将是最后一个），则该函数会优化其插入时间。
请注意，这不会强制将新元素放置在 map 容器内的该位置（map 中的元素始终遵循特定顺序）。
const_iterator是一个成员类型，定义为指向元素的 双向迭代器类型。

args

用于构造插入元素的新*mapped type*对象的参数。

转发给新元素（类型为pair<const key_type, mapped_type>）构造的参数。
这可以是以下之一：
- 两个参数：一个用于*key*，一个用于*mapped value*。
- 一个*pair*类型的单个参数，其第一个成员为*key*值，第二个成员为*mapped value*值。
- 第一个参数为*piecewise_construct*，另外两个参数为*tuples*，分别转发给*key value*和*mapped value*的构造函数参数。
有关更多信息，请参阅*pair::pair*。

返回值

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

// map::emplace_hint
#include <iostream>
#include <map>

int main ()
{
  std::map<char,int> mymap;
  auto it = mymap.end();

  it = mymap.emplace_hint(it,'b',10);
  mymap.emplace_hint(it,'a',12);
  mymap.emplace_hint(mymap.end(),'c',14);

  std::cout << "mymap contains:";
  for (auto& x: mymap)
    std::cout << " [" << x.first << ':' << x.second << ']';
  std::cout << '\n';

  return 0;
}

mymap contains: [a:12] [b:10] [c:14]

复杂度

迭代器有效性

数据竞争

异常安全

另见

map::emplace

构造并插入元素 (公开成员函数)

map::insert

插入元素 (公开成员函数)

map::erase

擦除元素 (公开成员函数)