set::emplace_hint

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

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

參數

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

傳回值

新插入之項目的迭代器。

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

備註

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

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

範例

// set_emplace.cpp
// compile with: /EHsc
#include <set>
#include <string>
#include <iostream>

using namespace std;

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

    for (const auto& p : s) {
        cout << "(" << p <<  ") ";
    }

    cout << endl;
}

int main()
{
    set<string> s1;

    // Emplace some test data
    s1.emplace("Anna");
    s1.emplace("Bob");
    s1.emplace("Carmine");

    cout << "set starting data: ";
    print(s1);
    cout << endl;

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

    cout << "set modified, now contains ";
    print(s1);
    cout << endl;
}

Output

set starting data: 3 elements:
(Anna) (Bob) (Carmine)

set modified, now contains 4 elements:
(Anna) (Bob) (Carmine) (Doug)

需求

標頭: <set>

命名空間: std

請參閱

參考

<set>

set 類別

標準樣板程式庫