unordered_map::emplace_hint
Insère un élément construit en place (aucune opération de copie ou de mouvements n'est exécutée), avec un indicateur de positionnement.
template<class... Args>
iterator emplace_hint(
const_iterator where,
Args&&... args);
Paramètres
Paramètre |
Description |
args |
Les arguments transférés pour construire un élément à insérer dans l'unordered_map à moins que l'unordered_map comporte déjà cet élément ou, plus généralement, sauf s'il contient déjà un élément dont la clé est classée de façon équivalente. |
where |
Un indicateur concernant l'emplacement pour commencer la recherche du point correct d'insertion. |
Valeur de retour
Un itérateur pour l'élément récemment inséré.
Si l'insertion a échoué car l'élément existe déjà, un itérateur pour l'élément existant est retourné.
Notes
Aucune référence n'est invalidée par cette fonction.
Pendant l'insertion, si une exception est levée mais pas dans la fonction de hachage du conteneur, le conteneur n'est pas modifié. Si l'exception est levée dans la fonction de hachage, le résultat n'est pas défini.
La value_type d'un élément consiste des paires, afin que la valeur d'un élément soit une paire classée avec comme premier composant la valeur de clé et le second composant égal à la valeur de l'élément.
Pour obtenir un exemple de code, consultez map::emplace_hint.
Configuration requise
En-tête : <unordered_map>
Espace de noms : std