unordered_multimap::insert
Vloží do unordered_multimap 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_multimap. |
Where |
Místo zahájení vyhledání správného bodu vložení. |
ValTy |
Parametr šablony, který určuje typ argumentu, který unordered_multimap 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 vložení funkce členů (1) a (2), vrátí iterace pozice vložena nového elementu do unordered_multimap.
Jeden element s nápovědu členské funkce, (3) a (4) vrátí iterace odkazující na pozici vložena nového elementu do unordered_multimap.
Poznámky
Tato funkce budou neplatné žádné ukazatele nebo odkazy, ale může ke zrušení platnosti všech iterátory do kontejneru.
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.
Objekt value_type kontejneru je definice typu, který náleží do kontejneru a pro objekt map<K, V>::value_type je pair<const K, V>.Hodnota prvku je seřazená dvojice, ve které je první komponenta rovna hodnotě klíče a druhá komponenta je rovna datové hodnotě prvku.
Členskou funkci rozsahu: [5] vloží posloupnost hodnoty elementů do unordered_multimap, která odpovídá každý prvek řešit iterace v rozsahu [First, Last); Proto Last získat není vložena.Funkce člena kontejneru end() odkazuje na pozici bezprostředně za posledním prvkem v kontejneru – například příkaz m.insert(v.begin(), v.end()); vloží všechny elementy v do m.
Člen inicializátoru seznamu funkce (6) používá initializer_list ke zkopírování elementů do unordered_multimap.
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 unordered_multimap::emplace a unordered_multimap::emplace_hint.
Příklad kódu naleznete v tématu multiset::insert.
Požadavky
Záhlaví: < unordered_map >
Obor názvů: std