Partager via


hash_set::insert

Notes

Cette API est obsolète.L'alternative est unordered_set, classe.

Insère un élément ou une plage d'éléments dans hash_set.

pair<iterator, bool> insert(
   const value_type& Val
);
iterator insert(
   iterator Where,
   const value_type& Val
); 
void insert(
    initializer_list<value_type> IList
)
template<class InputIterator>
   void insert(
      InputIterator First,
      InputIterator Last
);

Paramètres

Paramètre

Description

Val

La valeur d'un élément à insérer dans hash_set à moins que hash_set comporte déjà cet élément ou, plus généralement, un élément dont la clé est classée de façon équivalente.

Where

Emplacement pour commencer la recherche du point d'insertion correct. (L'insertion peut se produire dans le temps fixe amorti, au lieu du temps logarithmique, si le point d'insertion suit immédiatement _Where.)

First

La position du premier élément devant être être copié depuis hash_set.

Last

Position juste après celle de l'élément à copier from a hash_set.

IList

L'initializer_list depuis laquelle copier les éléments.

Valeur de retour

La première fonction membre insert retourne une paire dont le composant bool retourne true si une insertion a été réalisée ou false si hash_set contient déjà un élément dont la clé avait une valeur équivalente dans la commande, et dont le composant itérateur retourne l'adresse où un nouvel élément a été inséré ou lorsque l'élément a déjà été localisé.

Pour accéder au composant itérateur d'une paire pr retournée par cette fonction membre, utilisez pr.first , et pour le déréférencer, utilisez *(pr.first). Pour accéder au composant bool d'une paire pr retournée par cette fonction membre, utilisez pr.second, et pour le déréférencer, utilisez *(pr.second).

La deuxième fonction membre insert retourne un itérateur qui indique la position où le nouvel élément a été inséré dans hash_set.

Notes

La troisième fonction membre insère les éléments dans un initializer_list.

La troisième fonction membre insère la séquence de valeurs d'élément dans hash_set qui correspondant à chaque élément traité par un itérateur dans la plage [First, Last) de hash_setspécifié.

Configuration requise

Header: <hash_set>

Espace de noms : stdext

Voir aussi

Référence

hash_set, classe

Bibliothèque STL (Standard Template Library)