Condividi tramite


unordered_multimap::insert

aggiunge gli elementi.

iterator 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>
    iterator insert(ValTy&& val);
template<class ValTy>
    iterator insert(const_iterator where, ValTy&& val);

Parametri

Parametro

Descrizione

InIt

il tipo di iteratore.

ValTy

Il tipo sul posto dell'argomento del costruttore.

First

A partire dall'intervallo da inserire.

Last

estremità di intervallo da inserire.

Val

valore da inserire.

Where

La posizione del contenitore inserire (suggerimento solo).

Note

la prima funzione membro inserisce l'elemento val nella sequenza selezionata, quindi restituisce l'iteratore che definisce l'elemento inserito.I secondi termine della funzione membro insert(val)tramite, where come posizione iniziale all'interno della sequenza controllata da individuare il punto di inserimento.(Inserimento può anche verificarsi leggermente più veloce, se il punto di inserimento immediatamente precedente a o segue where).

La terza funzione membro inserire la sequenza di valori degli elementi, per ognuno where nell'intervallo [first, last), chiamando insert(*where).

Le ultime due funzioni membro si comportano allo stesso modo dei primi due, eccetto val viene utilizzato per costruire il valore immesso.

Se viene generata un'eccezione durante l'inserimento di un singolo elemento, il contenitore resta invariato e l'eccezione viene generata di nuovo.Se viene generata un'eccezione durante l'inserimento di più elementi, il contenitore viene lasciato in uno stabile ma lo stato non specificato e l'eccezione viene generata di nuovo.

Esempio

// std_tr1__unordered_map__unordered_multimap_insert.cpp 
// compile with: /EHsc 
#include <unordered_map> 
#include <iostream> 
#include <string>
 
typedef std::unordered_multimap<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 new and duplicate, and reinspect 
    c1.insert(Mymap::value_type('e', 5)); 
    c1.insert(Mymap::value_type('a', 6)); 
    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_multimap<int, string> c3, c4;
    pair<int, string> is1(1, "a"), is2(2, "b");

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

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

Requisiti

intestazione: <unordered_map>

Spazio dei nomi: deviazione standard

Vedere anche

Riferimenti

<unordered_map>

unordered_multimap Class

Altre risorse

<unordered_map> membri