std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: insert

컨테이너에 동등한 키를 가진 요소가 아직 없는 경우 요소를 삽입합니다.

만약 연산 후 새로운 원소의 개수가 기존 max_load_factor() * bucket_count() 보다 크면 재해싱이 발생합니다.
재해싱이 발생하는 경우(삽입으로 인해), 모든 반복자는 무효화됩니다. 그렇지 않은 경우(재해싱 없음), 반복자는 무효화되지 않습니다. 삽입이 성공하면, 노드 핸들에 보관되는 동안 획득한 해당 원소에 대한 포인터와 참조는 무효화되며, 추출되기 전에 해당 원소에 대해 획득한 포인터와 참조는 유효해집니다. (C++17부터)

매개변수

반환값

예외

복잡도

참고 사항

힌트 삽입 ( ( 4-6 ) 및 ( 10 ) )은 std::vector::insert 와 같은 순차 컨테이너의 위치 기반 삽입과 시그니처 호환성을 유지하기 위해 부울 값을 반환하지 않습니다. 이를 통해 std::inserter 와 같은 일반화된 삽입기를 생성할 수 있습니다. 힌트 삽입의 성공 여부를 확인하는 한 가지 방법은 삽입 전후의 size() 를 비교하는 것입니다.

예제

#include <iostream>
#include <string>
#include <unordered_map>
int main ()
{
    std::unordered_map<int, std::string> dict = {{1, "one"}, {2, "two"}};
    dict.insert({3, "three"});
    dict.insert(std::make_pair(4, "four"));
    dict.insert({{4, "another four"}, {5, "five"}});
    const bool ok = dict.insert({1, "another one"}).second;
    std::cout << "inserting 1 => \"another one\" "
              << (ok ? "succeeded" : "failed") << '\n';
    std::cout << "contents:\n";
    for (auto& p : dict)
        std::cout << ' ' << p.first << " => " << p.second << '\n';
}

inserting 1 => "another one" failed
contents:
 5 => five
 1 => one
 2 => two
 3 => three
 4 => four

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목