std::unordered_multiset<Key,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é.

Les constructeurs de la clé et de la valeur mappée sont appelés 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 ( strong exception safety guarantee ).

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)