unordered_set::insert
Vloží do unordered_set elementu nebo rozsahu prvků.
// (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 );
Parametry
Parametr |
Popis |
Val |
Hodnota elementu, který má být vložena do unordered_set, pokud již obsahuje element, jehož klíč je ekvivalentně řazení. |
Where |
Místo zahájení vyhledání správného bodu vložení. |
ValTy |
Parametr šablony, který určuje typ argumentu, který unordered_set lze použít při sestavování element value_typea předávat dokonalé Val jako argument. |
First |
Pozice prvního prvku, který chcete zkopírovat. |
Last |
Pozice bezprostředně za posledním prvkem, který chcete zkopírovat. |
InputIterator |
Argument funkce šablony, který splňuje požadavky vstupního iterátoru, který odkazuje na prvky typu, který lze použít k vytvoření objektů value_type. |
IList |
Seznam initializer_list, ze kterého chcete kopírovat prvky. |
Vrácená hodnota
Jeden element členské funkce (1) a (2), vrátí dvojici jehož bool komponenta je hodnota true, pokud bylo provedeno vložení a hodnota false, pokud unordered_set již obsahuje element, jehož klíč má odpovídající hodnoty v pořadí.Komponenta iterátoru dvojice návratové hodnoty odkazuje na nově vložený prvek, pokud má komponenta bool hodnotu true, nebo na existující prvek, pokud má komponenta bool hodnotu false.
Jeden element s nápovědu členské funkce, (3) a (4) vrátí iterace odkazující na umístění, kde nového elementu byla vložena do unordered_set, nebo pokud již existuje element se ekvivalentní klíčem, do existujícího elementu.
Poznámky
Touto funkcí nejsou zneplatněny žádné iterátory, ukazatele ani odkazy.
Pokud je při vložení pouze jednoho prvku vyvolána výjimka, ale nenastane v kontejneru funkce hash, stav kontejneru se nezmění.Pokud je vyvolána výjimka ve funkci hash, výsledek není definován.Pokud je při vkládání více prvků vyvolána výjimka, kontejner zůstane v neurčeném, ale platném stavu.
To access the iterator component of a pairpr that's returned by the single-element member functions, use pr.first; to dereference the iterator within the returned pair, use *pr.first, giving you an element.Chcete-li přistupovat ke komponentě bool, použijte pr.second.Příklad naleznete v ukázce kódu dále v tomto článku.
Value_type kontejneru je definice typu, který patří do kontejneru a pro sadu, unordered_set<V>::value_type je typ const V.
Členskou funkci rozsahu: [5] vloží posloupnost hodnoty elementů do unordered_set, která odpovídá každý prvek řešit iterace v rozsahu [First, Last); Proto Last získat není vložena.Členská funkce kontejneru end() se vztahuje k pozici hned za posledním prvkem v kontejneru, například příkaz s.insert(v.begin(), v.end()); se pokusí vložit všechny prvky v do s.Vkládají se pouze prvky, které v rozsahu obsahují jedinečné hodnoty. Duplicitní hodnoty jsou ignorovány.Chcete-li sledovat, které prvky jsou odmítnuty, použijte jednoprvkovou verzi funkce insert.
Člen inicializátoru seznamu funkce (6) používá initializer_list ke zkopírování elementů do unordered_set.
Další informace o vložení prvku vytvořeného na místě – to znamená, že nejsou provedeny žádné operace kopírování nebo přesunutí – naleznete v tématech set::emplace a set::emplace_hint.
Příklad kódu naleznete v tématu set::insert.
Požadavky
Záhlaví: < unordered_set >
Obor názvů: std