hash_map::insert

注意事項
這個 API 已經過時。替代方案是 unordered_map 類別。

插入項目的範圍入 hash_map。

pair <iterator, bool> insert(
    const value_type& _Val
);
iterator insert(
    const_iterator _Where,
    const value_type& _Val
);
template<class InputIterator>
    void insert(
        InputIterator _First,
        InputIterator _Last
);
template<class ValTy>
    pair <iterator, bool> insert(
        ValTy&& _Val
);
template<class ValTy>
    iterator insert(
        const_iterator _Where,
        ValTy&& _Val
);

參數

參數	說明
_Val	索引鍵相等地排列) 將項目插入至 hash_map，除非 hash_map 已經包含項目 (或，一般來說，項目的值。
_Where	提示，關於開始搜尋正確插入點的位置。
_First	第一個項目位置複製從 hash_map。
_Last	位置在最後項目以外的複製 hash_map。

傳回值

第一個 insert 成員函式傳回 bool 元件傳回 true 的配對，如果插入已建立和，如果 hash_map 已經包含了索引鍵 Common Language Runtime 在定序，因此， Iterator 元件傳回位址或插入新項目的項目已經在位置項目。

若要存取一對 pr 的 Iterator 元件此成員函式傳回，則使用 pr。first和解除參考它，請使用* (pr。first)。 若要存取一對 pr 的 bool 元件此成員函式傳回，則使用 pr。second和解除參考它，請使用* (pr。second)。

第二個 insert 成員函式，指向位置插入新項目到 hash_map 的提示版本，傳回 Iterator。

最後兩個 insert 成員函式一般作業的前兩個相同，不過，它們移動建構插入的值。

備註

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

如果插入點緊接在 _Where，插入插入提示版本中為舊的常數時間可能發生，而不是對的時間。

第三 + 成成員函式插入項目值序列 hash_map 與在範圍中處理的每個項目對應 [首先，最後) 中指定的集合。

範例

// hash_map_insert.cpp
// compile with: /EHsc
#include<hash_map>
#include<iostream>
#include <string>

int main()
{
    using namespace std;
    using namespace stdext;
    hash_map<int, int>::iterator hm1_pIter, hm2_pIter;

    hash_map<int, int> hm1, hm2;
    typedef pair<int, int> Int_Pair;

    hm1.insert(Int_Pair(1, 10));
    hm1.insert(Int_Pair(2, 20));
    hm1.insert(Int_Pair(3, 30));
    hm1.insert(Int_Pair(4, 40));

    cout<< "The original elements (Key => Value) of hm1 are:";
    for (hm1_pIter = hm1.begin(); hm1_pIter != hm1.end(); hm1_pIter++)
        cout << endl << " " << hm1_pIter -> first << " => "
             << hm1_pIter->second;
    cout << endl;

    pair< hash_map<int,int>::iterator, bool > pr;
    pr = hm1.insert(Int_Pair(1, 10));

    if (pr.second == true)
    {
        cout<< "The element 10 was inserted in hm1 successfully."
            << endl;
    }
    else
    {
        cout<< "The element 10 already exists in hm1\n with a key value of"
            << "((pr.first) -> first)= "<<(pr.first)-> first
            << "."<< endl;
    }

    // The hint version of insert
    hm1.insert(--hm1.end(), Int_Pair(5, 50));

    cout<< "After the insertions, the elements of hm1 are:";
    for (hm1_pIter = hm1.begin(); hm1_pIter != hm1.end(); hm1_pIter++)
        cout << endl << " " << hm1_pIter -> first << " => "
             << hm1_pIter->second;
    cout << endl;

    hm2.insert(Int_Pair(10, 100));

    // The templatized version inserting a range
    hm2.insert( ++hm1.begin(), --hm1.end() );

    cout<< "After the insertions, the elements of hm2 are:";
    for (hm2_pIter = hm2.begin(); hm2_pIter != hm2.end(); hm2_pIter++)
        cout << endl << " " << hm2_pIter -> first << " => "
             << hm2_pIter->second;
    cout << endl;

    // The templatized versions move constructing elements
    hash_map<int, string> hm3, hm4;
    pair<int, string> is1(1, "a"), is2(2, "b");

    hm3.insert(move(is1));
    cout << "After the move insertion, hm3 contains:" << endl
      << " " << hm3.begin()->first
      << " => " << hm3.begin()->second
      << endl;

    hm4.insert(hm4.begin(), move(is2));
    cout << "After the move insertion, hm4 contains:" << endl
      << " " << hm4.begin()->first
      << " => " << hm4.begin()->second
      << endl;
}

需求

標頭檔: <hash_map>

**命名空間：**stdext

請參閱

參考

hash_map 類別

標準樣板程式庫