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

擦除元素 (公開成員函式)