unordered_map::insert

Článek
03/04/2013

Přidá prvky.

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);

Parametry

Parametr	Description
InIt	Typ iterace.
ValTy	Typ argumentu v místě konstruktor.
first	Začátek rozsahu vložit.
last	Konec rozsahu vložit.
val	Vložit hodnotu.
where	Kde v kontejneru vložit (pouze tip).

Poznámky

První členské funkce určuje, zda prvek X existuje v posloupnosti, jehož klíč má ekvivalentní objednávání, val.Pokud není, vytvoří takový prvek X a inicializuje s val.Funkce potom určí iterace where , označí X.Pokud došlo vložení, vrátí funkce std::pair(where, true).V ostatních případech vrátí hodnotu std::pair(where, false).

Vrátí druhou členské funkce insert(val).first, použití where jako počáteční místo v rámci řízeného pořadí hledání kurzor.(Vložení může případně dojít poněkud rychlejší, pokud kurzor bezprostředně předchází nebo následuje where.)

Třetí členské funkce vloží posloupnost hodnot prvků pro každou where v rozsahu [first, last), voláním insert(*where).

Funkce posledních dvou členů se chovají stejně jako první dva kromě val se používá pro sestavení vložené hodnoty.

Pokud během vložení jednoho prvku je výjimka, kontejner je ponechán v nezměněném stavu a je výjimka rethrown.Pokud během vkládání více prvků je výjimka, kontejner je ponechána ve stavu stabilní, ale nespecifikované a je výjimka rethrown.

Příklad

// std_tr1__unordered_map__unordered_map_insert.cpp 
// compile with: /EHsc 
#include <unordered_map> 
#include <iostream> 
#include <string>
 
typedef std::unordered_map<char, int> Mymap; 
int main() 
    { 
    Mymap c1; 
 
    c1.insert(Mymap::value_type('a', 1)); 
    c1.insert(Mymap::value_type('b', 2)); 
    c1.insert(Mymap::value_type('c', 3)); 
 
// display contents " [c 3] [b 2] [a 1]" 
    for (Mymap::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << it->first << ", " << it->second << "]"; 
    std::cout << std::endl; 
 
// insert with hint and reinspect 
    Mymap::iterator it2 = c1.insert(c1.begin(), Mymap::value_type('d', 4)); 
    for (Mymap::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << it->first << ", " << it->second << "]"; 
    std::cout << std::endl; 
 
// insert range and inspect 
    Mymap c2; 
 
    c2.insert(c1.begin(), c1.end()); 
    for (Mymap::const_iterator it = c2.begin(); 
        it != c2.end(); ++it) 
        std::cout << " [" << it->first << ", " << it->second << "]"; 
    std::cout << std::endl; 
 
// insert with checking and reinspect 
    std::pair<Mymap::iterator, bool> pib = 
        c1.insert(Mymap::value_type('e', 5)); 
    std::cout << "insert(['a', 5]) success == " 
        << std::boolalpha << pib.second << std::endl; 
    pib = c1.insert(Mymap::value_type('a', 6)); 
    std::cout << "insert(['a', 5]) success == " 
        << std::boolalpha << pib.second << std::endl; 
    for (Mymap::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << it->first << ", " << it->second << "]"; 
    std::cout << std::endl; 

// The templatized versions move constructing elements
    unordered_map<int, string> c3, c4;
    pair<int, string> is1(1, "a"), is2(2, "b");

    c3.insert(std::move(is1));
    std::cout << "After the move insertion, c3 contains:" << std::endl
      << " " << c3.begin()->first
      << " => " << c3.begin()->second
      << std::endl;

    c4.insert(c4.begin(), std::move(is2));
    std::cout << "After the move insertion, c4 contains:" << std::endl
      << " " << c4.begin()->first
      << " => " << c4.begin()->second
      << std::endl;
 
    return (0); 
    }

Požadavky

Záhlaví: <unordered_map>

Obor názvů: std

Viz také

Referenční dokumentace

<unordered_map>

unordered_map Class

Další zdroje

<unordered_map> Členové

Sdílet prostřednictvím