multimap::emplace

插入就地建構的項目 (複製或移動作業未執行) 進入對應。

template<class... Args>
   iterator emplace(
      Args&&... args);

參數

參數	說明
args	引數，其將轉送至建構欲插入多重對應的項目。

傳回值

新插入之項目的迭代器。

備註

容器項目的參考對此函式皆為有效，不過，此函式可能無法使用容器中所有的迭代器。

如果例外狀況在插入時擲回，容器會保持不變，並重新擲回例外狀況。

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

範例

// multimap_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()
{
    multimap<string, string> m1;

    m1.emplace("Anna", "Accounting");
    m1.emplace("Bob", "Accounting");
    m1.emplace("Carmine", "Engineering");

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

    m1.emplace("Bob", "Engineering");

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

Output

multimap modified, now contains 3 elements:
(Anna,Accounting) (Bob,Accounting) (Carmine,Engineering)

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

需求

標頭：<map>

命名空間: std

請參閱

參考

<map>

multimap 類別

標準樣板程式庫