hash_set::insert
[!REMARQUE]
Cette API est obsolète.l'alternative est unordered_set Class.
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
);
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 qu' hash_set contienne déjà cet élément ou, plus généralement, un élément dont la clé est de façon équivalente classée. |
_Where |
L'emplacement pour commencer à rechercher le point correct d'implémentation.(L'implémentation peut se produire dans le temps fixe amorti, au lieu du temps logarithmique, si le point d'insertion suit immédiatement _Where.) |
_First |
Position du premier élément à copier d' hash_set. |
_Last |
La position immédiatement au delà de le dernier élément à copier d' hash_set. |
Valeur de retour
La première fonction membre d' insert retourne une paire de le composant d' bool retourne true si une implémentation était font et false si hash_set contenait déjà un élément dont la clé a eu une valeur équivalente dans l'ordre, 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 d'itérateur d'une paire pr retourné par cette fonction membre, utilisez pr.firstet le déréférencement, utilisez *(pr.first).Pour accéder au composant d' bool d'une paire pr retourné par cette fonction membre, utilisez pr.second, et le déréférencement, utilisez *(pr.second).
La deuxième fonction membre d' 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 la séquence de valeurs d'élément dans hash_set correspondant à chaque élément traité par un itérateur de dans la plage [_First, _Last) d' hash_setspécifié.
Exemple
// hash_set_insert.cpp
// compile with: /EHsc
#include <hash_set>
#include <iostream>
int main( )
{
using namespace std;
using namespace stdext;
hash_set <int>::iterator hs1_pIter, hs2_pIter;
hash_set <int, hash_compare <int, less<int> > > hs1, hs2;
hs1.insert( 10 );
hs1.insert( 20 );
hs1.insert( 30 );
hs1.insert( 40 );
cout << "The original hs1 =";
for ( hs1_pIter = hs1.begin( ); hs1_pIter != hs1.end( );
hs1_pIter++ )
cout << " " << *hs1_pIter;
cout << "." << endl;
pair< hash_set<int>::iterator, bool > pr;
pr = hs1.insert( 10 );
if(pr.second == true)
{
cout << "The element 10 was inserted in hs1 successfully."
<< endl;
}
else
{
cout << "The element 10 already exists in hs1 and"
<< " *( pr.first ) = " << *( pr.first ) << "."
<< endl;
}
hs1.insert( --hs1.end( ), 50 );
cout << "After the insertions, hs1 =";
for ( hs1_pIter = hs1.begin( ); hs1_pIter != hs1.end( );
hs1_pIter++ )
cout << " " << *hs1_pIter;
cout << "." << endl;
hs2.insert( 100 );
hs2.insert( ++hs1.begin( ), --hs1.end( ) );
cout << "hs2 =";
for ( hs2_pIter = hs2.begin( ); hs2_pIter != hs2.end( );
hs2_pIter++ )
cout << " " << *hs2_pIter;
cout << "." << endl;
}
Configuration requise
en-tête : <hash_set>
Stdext del'espace de noms :