Condividi tramite


multimap::insert (STL/CLR)

Aggiunge gli elementi.

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

Parametri

  • innanzitutto
    A partire dall'intervallo da inserire.

  • last
    Estremità di intervallo da inserire.

  • right
    Enumerazione da inserire.

  • val
    Valore della chiave da inserire.

  • where
    La posizione del contenitore inserire (suggerimento solo).

Note

Ognuna delle funzioni membro inserire una sequenza specificata dagli operandi rimanenti.

La prima funzione membro inserire un elemento con valore vale restituisce un iteratore che definisce l'elemento appena inserito.Viene utilizzato per inserire un singolo elemento.

La seconda funzione membro inserire un elemento con valore val, utilizzando where come suggerimento (per migliorare le prestazioni) e restituisce un iteratore che definisce l'elemento appena inserito.La si utilizza per inserire un singolo elemento che può essere adiacenti a un elemento che si conosce.

La terza funzione membro inserire la sequenza [first,last).La si utilizza per inserire zero o più elementi copiati da un'altra sequenza.

La quarta funzione membro inserire la sequenza definita da right.La si utilizza per inserire una sequenza descritta da un enumeratore.

Ogni inserimento dell'elemento richiede tempo proporzionale al logaritmo del numero di elementi della sequenza selezionata.L'inserimento può verificarsi nel tempo costante ammortizzato, tuttavia, dato un suggerimento che definisce un elemento adiacente al punto di inserimento.

Esempio

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

Requisiti

intestazione: <cliext/mapping>

Cliext diSpazio dei nomi:

Vedere anche

Riferimenti

multimap (STL/CLR)