std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>:: emplace_hint

template < class ... Args > iterator emplace_hint ( const_iterator hint, Args && ... args ) ;		(depuis C++11) (constexpr depuis C++26)

Insère un nouvel élément dans le conteneur, en utilisant hint comme suggestion pour l'emplacement où l'élément devrait être placé.

Le constructeur de value_type (c'est-à-dire, std:: pair < const Key, T > ) est appelé avec exactement les mêmes arguments que ceux fournis à la fonction, transmis avec std:: forward < Args > ( args ) ... .

Si après l'opération le nouveau nombre d'éléments est supérieur à l'ancien max_load_factor() * bucket_count() un rehashing a lieu.
Si un rehashing se produit (en raison de l'insertion), tous les itérateurs sont invalidés. Sinon (aucun rehashing), les itérateurs ne sont pas invalidés.

Table des matières 1 Paramètres 2 Valeur de retour 3 Exceptions 4 Complexité 5 Exemple 6 Voir aussi

Paramètres

hint	-	itérateur, utilisé comme suggestion pour l'emplacement d'insertion du nouvel élément
args	-	arguments à transmettre au constructeur de l'élément

Valeur de retour

Un itérateur vers l'élément inséré.

Exceptions

Si une exception est levée pour quelque raison que ce soit, cette fonction n'a aucun effet ( garantie forte de sûreté face aux exceptions ).

Complexité

Amorti constant en moyenne, linéaire dans le pire des cas selon la taille du conteneur.

Exemple

Cette section est incomplète Raison : aucun exemple

Voir aussi

emplace	construit un élément en place (fonction membre publique)
insert	insère des éléments ou des nœuds (depuis C++17) (fonction membre publique)