unordered_multimap::insert
unordered_multimap에 요소 또는 요소의 범위를 삽입합니다.
// (1) single element pair<iterator, bool> insert( const value_type& Val ); // (2) single element, perfect forwarded template<class ValTy> pair<iterator, bool> insert( ValTy&& Val ); // (3) single element with hint iterator insert( const_iterator Where, const value_type& Val ); // (4) single element, perfect forwarded, with hint template<class ValTy> iterator insert( const_iterator Where, ValTy&& Val ); // (5) range template<class InputIterator> void insert( InputIterator First, InputIterator Last ); // (6) initializer list void insert( initializer_list<value_type> IList );
매개 변수
매개 변수 |
설명 |
Val |
unordered_multimap에 삽입할 요소의 값입니다. |
Where |
올바른 삽입 지점 검색을 시작할 위치입니다. |
ValTy |
unordered_multimap이 value_type의 요소를 생성하는 데 사용할 수 있는 인수 형식을 지정하고 Val을 인수로 완벽하게 전달하는 템플릿 매개 변수입니다. |
First |
복사할 첫 번째 요소의 위치입니다. |
Last |
복사할 마지막 요소 바로 다음 위치입니다. |
InputIterator |
value_type 개체를 생성하는 데 사용할 수 있는 형식의 인수를 가리키는 입력 반복기의 요구 사항을 충족하는 템플릿 함수 인수입니다. |
IList |
요소를 복사해올 initializer_list입니다. |
반환 값
단일 요소 삽입 멤버 함수 (1) 및 (2)는 unordered_multimap에 새 요소를 삽입한 위치로 반복기를 반환합니다.
힌트가 있는 단일 요소 멤버 함수 (3) 및 (4)는 unordered_multimap에 새 요소를 삽입한 위치를 가리키는 반복기를 반환합니다.
설명
이 함수는 어떠한 포인터 또는 참조를 무효화하지 않지만 컨테이너에 대한 모든 반복기를 무효화할 수 있습니다.
요소를 하나만 삽입하는 중 예외가 throw되었으나 컨테이너의 해시 함수에서 발생하지 않은 경우에는 컨테이너의 상태가 수정되지 않습니다. 예외가 해시 함수에서 throw된 경우 결과는 정의되어 있지 않습니다. 여러 요소를 삽입하는 중 예외가 throw되면 컨테이너는 지정되지 않았으나 유효한 상태로 남아 있습니다.
컨테이너의 value_type은 컨테이너에 속한 typedef이고 맵의 경우 map<K, V>::value_type은 pair<const K, V>입니다. 요소의 값은 첫 번째 구성 요소가 키 값과 동일하고 두 번째 구성 요소는 요소의 데이터 값과 동일한 정렬된 쌍입니다.
범위 멤버 함수 (5)는 [First, Last) 범위에서 반복기가 주소를 지정하는 각 요소에 해당하는 요소 값 시퀀스를 unordered_multimap에 삽입합니다. 따라서 Last는 삽입되지 않습니다. 컨테이너 멤버 함수 **end()**는 컨테이너의 마지막 요소 바로 뒤에 있는 위치를 참조합니다. 예를 들어 m.insert(v.begin(), v.end()); 문은 v의 모든 요소를 m에 삽입합니다.
이니셜라이저 목록 멤버 함수 (6)은 initializer_list를 사용하여 요소를 unordered_multimap으로 복사합니다.
생성된 요소를 제 위치에 삽입하려면, 즉 복사 또는 이동 작업을 수행하지 않으려면 unordered_multimap::emplace 및 unordered_multimap::emplace_hint를 참조하세요.
코드 예제를 보려면 multiset::insert를 참조하십시오.
요구 사항
헤더: <unordered_map>
네임스페이스: std