unordered_set::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 inoltrati per costruire un elemento da inserire in una unordered_set a meno che la unordered_set non contenga già tale elemento, o più in generale, a meno che non contenga già un elemento la cui la chiave sia equivalentemente ordinata. |
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.
Se l'inserimento ha avuto esito negativo perché l'elemento esiste già, restituisce un iteratore all'elemento esistente.
Note
Nessun iteratore o puntatore, viene invalidato da questa funzione.
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 set::emplace_hint.
Requisiti
Intestazione: <unordered_set>
Spazio dei nomi: std