unordered_multimap::emplace_hint
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_hint(
const_iterator where,
Args&&... args);
Parametri
Parametro |
Descrizione |
args |
Gli argomenti passati per costruire un elemento da inserire nell'insieme non ordinato. |
where |
Un suggerimento per quanto riguarda la posizione per avviare la ricerca del punto di inserimento corretto. |
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.
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.
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.
Per un esempio di codice, vedere map::emplace_hint.
Requisiti
Header: <unordered_multimap>
Spazio dei nomi: std