unordered_multimap::emplace
Inserisce un elemento costruito in locale (senza che vengano eseguite operazioni di copia o di spostamento), con un suggerimento di posizione.
template<class... Args>
iterator emplace(
Args&&... args);
Parametri
Parametro |
Descrizione |
args |
Gli argomenti passati per costruire un elemento da inserire nel unordered_multimap. |
Valore restituito
Un iteratore all'elemento appena inserito.
Note
Nessun riferimento agli elementi contenitore viene invalidato da questa funzione, ma può invalidare tutti gli iteratori al contenitore.
Il value_type di un elemento è una coppia, tale che il valore di un elemento sarà una coppia ordinata con il primo componente uguale al valore della chiave e il secondo uguale al valore del dato dell'elemento.
Durante l'inserimento, se viene generata un'eccezione ma non si trova nella funzione hash del contenitore, il contenitore non viene modificato. Se viene generata un'eccezione nella funzione hash, il risultato sarà indefinito.
Per un esempio di codice, vedere multimap::emplace.
Requisiti
Intestazione: <map>
Spazio dei nomi: std