map::emplace_hint

與放置提示，插入就地建構 (未經複製或移動操作)的項目。

template<class... Args>
   iterator emplace_hint(
      const_iterator where,
      Args&&... args);

參數

參數	說明
args	引數轉送至建構一個元素以插入至對應表，除非對應表已經包含該項目，或就一般而言，除非已經包含一個其索引鍵同於它的排序的項目。
where	正確的搜尋插入點之起始位置。(如果該節點在 where之前，插入可於平攤常數時間而非對數時間發生)。

傳回值

新插入之項目的迭代器。

如果因為這個項目已經存在而造成插入失敗，則與它的索引鍵値傳回迭代器至現有項目。

備註

任何迭代器、指標或是參考皆可使用此函式。

在當地語系化期間，除非擲回例外狀況，容器的狀態不會被修改。

項目的 value_type 是一對，因此元素，的值會與第一個元件等於這個機碼值和第二個元件的已排序配對等於這個項目之資料值。

範例

// map_emplace.cpp
// compile with: /EHsc
#include <map>
#include <string>
#include <iostream>

using namespace std;

template <typename M> void print(const M& m) {
    cout << m.size() << " elements: " << endl;

    for (const auto& p : m) {
        cout << "(" << p.first <<  "," << p.second << ") ";
    }

    cout << endl;
}

int main()
{
    map<string, string> m1;

    // Emplace some test data
    m1.emplace("Anna", "Accounting");
    m1.emplace("Bob", "Accounting");
    m1.emplace("Carmine", "Engineering");

    cout << "map starting data: ";
    print(m1);
    cout << endl;

    // Emplace with hint
    // m1.end() should be the "next" element after this emplacement
    m1.emplace_hint(m1.end(), "Doug", "Engineering");

    cout << "map modified, now contains ";
    print(m1);
    cout << endl;
}

Output

map starting data: 3 elements:
(Anna,Accounting) (Bob,Accounting) (Carmine,Engineering)

map modified, now contains 4 elements:
(Anna,Accounting) (Bob,Accounting) (Carmine,Engineering) (Doug,Engineering)

需求

標頭：<map>

命名空間: std

請參閱

參考

<map>

map 類別

標準樣板程式庫