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 nella multimap. |
where |
La posizione per avviare la ricerca per il punto di inserimento corretto. (Se tale punto è immediatamente seguito da where, l'inserimento può verificarsi in tempo costante ammortizzato invece che in tempo logaritmico.) |
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 il collocamento, se viene generata un'eccezione, lo stato del contenitore non viene modificato.
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
Intestazione: <map>
Spazio dei nomi: std