unordered_set::insert
요소를 추가합니다.
std::pair<iterator, bool> insert(const value_type& val);
iterator insert(iterator where, const value_type& val);
template<class InIt>
void insert(InIt first, InIt last);
template<class ValTy>
pair<iterator, bool> insert(ValTy&& val);
template<class ValTy>
iterator insert(const_iterator where, ValTy&& val);
매개 변수
Parameter |
설명 |
InIt |
반복기의 형식입니다. |
ValTy |
내부 생성자 인수 형식입니다. |
first |
삽입할 범위의 시작 부분입니다. |
last |
삽입할 범위의 끝 날짜입니다. |
val |
삽입할 값입니다. |
where |
(참고만) 삽입할 컨테이너에서 위치입니다. |
설명
요소가 있는지 여부를 결정 하는 첫 번째 멤버 함수 X 는 키가에 해당 하는 정렬 순서에 있는 val.이러한 요소 만드는 않는 경우 X 를 초기화 하 고 val.함수는 다음 반복기 결정 where 지정 된 X.삽입 하는 경우 발생 하는 함수 반환 std::pair(where, true).그렇지 않으면 std::pair(where, false)가 반환됩니다.
두 번째 멤버 함수를 반환 합니다. insert(val).first사용 하 여 where 안에 삽입 포인터를 검색 하는 제어 되는 시퀀스 시작 지점으로 합니다.(삽입 가능한 경우 발생할 수 있습니다 다소 더 빠르게 삽입 포인터 바로 앞에 또는 뒤 where.)
시퀀스의 요소 값 각각에 대해 세 번째 멤버 함수를 삽입 where 범위에서 [first, last)를 호출 하 여 insert(*where).
마지막으로 두 명의 멤버 함수를 제외 하 고 처음 두와 똑같이 동작 val 삽입 된 값을 생성 하는 데 사용 됩니다.
단일 요소를 삽입 하는 동안 예외가 발생 하는 경우 컨테이너 왼쪽입니다 변경 되지 않은 및 예외를 다시 throw 합니다.여러 요소를 삽입 하는 동안 예외가 발생 하는 경우 컨테이너는 안정적 이지만 알 수 없는 상태에 왼쪽과 예외가 다시 throw 됩니다.
예제
// std_tr1__unordered_set__unordered_set_insert.cpp
// compile with: /EHsc
#include <unordered_set>
#include <iostream>
#include <string>
typedef std::unordered_set<char> Myset;
int main()
{
Myset c1;
c1.insert('a');
c1.insert('b');
c1.insert('c');
// display contents " [c] [b] [a]"
for (Myset::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << *it << "]";
std::cout << std::endl;
// insert with hint and reinspect
Myset::iterator it2 = c1.insert(c1.begin(), 'd');
for (Myset::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << *it << "]";
std::cout << std::endl;
// insert range and inspect
Myset c2;
c2.insert(c1.begin(), c1.end());
for (Myset::const_iterator it = c2.begin();
it != c2.end(); ++it)
std::cout << " [" << *it << "]";
std::cout << std::endl;
// insert with checking and reinspect
std::pair<Myset::iterator, bool> pib =
c1.insert('e');
std::cout << "insert(['a',]) success == "
<< std::boolalpha << pib.second << std::endl;
pib = c1.insert('a');
std::cout << "insert(['a',]) success == "
<< std::boolalpha << pib.second << std::endl;
for (Myset::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << *it << "]";
std::cout << std::endl;
// The templatized versions move constructing elements
unordered_set<string> c3, c4;
string str1("a"), str2("b");
c3.insert(move(str1));
cout << "After the move insertion, c3 contains: "
<< *c3.begin() << endl;
c4.insert(c4.begin(), move(str2));
cout << "After the move insertion, c4 contains: "
<< *c4.begin() << endl;
return (0);
}
요구 사항
헤더: <unordered_set>
네임 스페이스: std