다음을 통해 공유


hash_map::insert

[!참고]

이 API는 사용되지 않습니다.대신 unordered_map Class.

요소 또는 요소의 범위는 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
);

매개 변수

Parameter

설명

_Val

Hash_map의 해당 요소 (또는 더 일반적으로 요소와 동일한 키를 가진 순서가) 이미 포함 되어 있지 않으면 hash_map에 삽입할 요소의 값입니다.

_Where

올바른 삽입 지점에 대 한 검색을 시작 하는 곳에 대 한 힌트입니다.

_First

첫 번째 요소는 hash_map을 복사할 위치를 지정 합니다.

_Last

위치는 hash_map을 복사 하는 마지막 요소입니다.

반환 값

첫 번째 삽입 hash_map을 이미 키 같은 값의 순서에 있어 반복기 요소가 새 요소가 삽입 된 위치 또는 요소가 이미 배치 된 곳의 주소를 반환 하는 요소를 포함 하는 경우 false 부울 요소가 삽입이 수행 된 경우 true를 반환 하 고 멤버 함수 쌍을 반환 합니다.

한 쌍의 반복기 구성 요소에 액세스 하려면 pr 멤버 함수에 의해 반환 된를 사용 하 여 pr. 첫 번째를 사용 하 여 역참조 하 * (pr.첫 번째).액세스 하는 bool 구성 요소 쌍의 pr 멤버 함수에 의해 반환 된를 사용 하 여 pr. 두 번째를 사용 하 여 역참조 하 * (pr.두 번째).

두 번째 삽입 멤버 함수, 힌트 버전 hash_map에 새 요소 삽입 위치를 위치를 가리키는 반복기를 반환 합니다.

마지막 두 삽입 멤버 함수 동작 처음 두와 같은 이동 삽입 된 값을 생성 하는 것을 제외 하 고.

설명

Value_type 정렬 된 쌍의 키 값과 같은 첫 번째 구성 요소 및 요소의 데이터 값과 같은 두 번째 구성 요소 값은 요소의 수 있도록 한 쌍의 요소입니다.

삽입 하면 발생할 수 있습니다 힌트 버전에 삽입 로그 시간 대신 amortized 상수 시간에 바로 삽입 지점 다음에 오는 _Where.

셋째 멤버 함수는 hash_map의 반복기 범위에 의해 주소가 지정 된 각 요소에 해당 요소의 값 시퀀스 삽입 [First, Last) 지정 된 집합입니다.

예제

// 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 Class

표준 템플릿 라이브러리