map::INSERT (STL/CLR)

Článek
06/07/2013

Přidá prvky.

    cliext::pair<iterator, bool> insert(value_type val);
    iterator insert(iterator where, value_type val);
    template<typename InIter>
        void insert(InIter first, InIter last);
    void insert(System::Collections::Generic::IEnumerable<value_type>^ right);

Parametry

první
Začátek oblasti vložení.
poslední
Konec rozsahu vložit.
pravý
Výčet vložit.
Val
Hodnota klíče vložit.
kde
Kde v kontejneru vložit (pouze tip).

Poznámky

Každý člen funkce vloží určené operandy zbývající posloupnost.

Endeavors první členské funkce Vložit prvek s hodnotou vala vrátí dvojice hodnot X.Pokud X.second je PRAVDA, X.first označí nově vloženého prvku; jinak X.first označí element s ekvivalentní řazení, které je již existuje a je vložen žádný nový prvek.Pomocí vložit jeden prvek.

Druhý členské funkce vloží prvek s hodnotou val, použití where jako Tip (pro zvýšení výkonu) a vrátí iterace, který určuje nově vloženého prvku.Použijte k vložení jednoho prvku, který může být sousedící prvek, který znáte.

Třetí členské funkce vloží sekvence [first, last).Použijte k vložení nula nebo více prvků zkopírovaný z jiného pořadí.

Čtvrtý členské funkce vloží pořadí určené right.Použijte k vložení Sled popsaný čítač výčtu.

Každý prvek vložení trvá úměrný logaritmu počet prvků v řízené sekvenci.Vložení může dojít v amortized konstantní doby však uvedeny nápovědu, která označí kurzor vedle prvku.

Příklad

// cliext_map_insert.cpp 
// compile with: /clr 
#include <cliext/map> 
 
typedef cliext::map<wchar_t, int> Mymap; 
typedef Mymap::pair_iter_bool Pairib; 
int main() 
    { 
    Mymap c1; 
    c1.insert(Mymap::make_value(L'a', 1)); 
    c1.insert(Mymap::make_value(L'b', 2)); 
    c1.insert(Mymap::make_value(L'c', 3)); 
 
// display contents " [a 1] [b 2] [c 3]" 
    for each (Mymap::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
// insert a single value, unique and duplicate 
// insert a single value, success and failure 
    Pairib pair1 = c1.insert(Mymap::make_value(L'x', 24)); 
    System::Console::WriteLine("insert([L'x' 24]) = [[{0} {1}] {2}]", 
        pair1.first->first, pair1.first->second, pair1.second); 
 
    pair1 = c1.insert(Mymap::make_value(L'b', 2)); 
    System::Console::WriteLine("insert([L'b' 2]) = [[{0} {1}] {2}]", 
        pair1.first->first, pair1.first->second, pair1.second); 
 
    for each (Mymap::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
// insert a single value with hint 
    Mymap::iterator it = 
        c1.insert(c1.begin(), Mymap::make_value(L'y', 25)); 
    System::Console::WriteLine("insert(begin(), [L'y' 25]) = [{0} {1}]", 
        it->first, it->second); 
    for each (Mymap::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
// insert an iterator range 
    Mymap c2; 
    it = c1.end(); 
    c2.insert(c1.begin(), --it); 
    for each (Mymap::value_type elem in c2) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
// insert an enumeration 
    Mymap c3; 
    c3.insert(   // NOTE: cast is not needed 
        (System::Collections::Generic:: 
            IEnumerable<Mymap::value_type>^)%c1); 
    for each (Mymap::value_type elem in c3) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
    return (0); 
    }

Požadavky

Záhlaví: < cliext/map >

Obor názvů: cliext

Viz také

Referenční dokumentace

map (STL/CLR)

Sdílet prostřednictvím