hash_set::insert

Hinweis
Diese API ist veraltet.Die Alternative ist unordered_set Class.

Fügt ein Element oder einen Bereich von Elementen in hash_set ein.

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
);

Parameter

Parameter	Description
_Val	Der Wert eines in hash_set einzufügende Elements, es sei denn, hash_set bereits dieses Element oder, im Allgemeinen, ein - Element enthält, dessen Schlüssel gleichwertig sortiert wird.
_Where	Der Position, an der das Suchen für den richtigen Punkt der Einfügung zu starten.(Einfügung kann in amortisierter konstanter Zeit, anstelle von logarithmischen Zeit auftreten, wenn die Einfügemarke sofort _Where folgt.)
_First	Die Position des ersten Elements, von hash_set kopiert werden.
_Last	Die Position direkt über dem letzten Element hinaus, von hash_set kopiert werden.

Rückgabewert

Die erste insert-Memberfunktion gibt ein Paar zurück, dessen bool Komponente true zurückgibt, wenn eine Einfügung ausführen und false war, wenn hash_set bereits ein Element enthält, dessen Schlüssel einen ein in der Reihenfolge verfügt und dessen Iteratorkomponente die Adresse zurückgibt, in der ein neues Element eingefügt wurde, oder der das Element bereits gefunden wurde.

Um auf die Iteratorkomponente eines Paars pr zuzugreifen, das von dieser Memberfunktion zurückgegeben wird, verwenden Sie pr.first und sie, verwendet *(pr.first) zu dereferenzieren.Um auf die bool Komponente eines Paars pr zuzugreifen, das von dieser Memberfunktion zurückgegeben wird, verwenden Sie pr.second, und sie zu dereferenzieren, Verwendung *(pr.second).

Die zweite insert-Memberfunktion gibt einen Iterator zurück, der der Position zeigt, in der das neue Element in hash_set eingefügt wurde.

Hinweise

Die dritte Memberfunktion fügt die Sequenz von Elementwerten in hash_set entsprechend jedes Element ein, das durch einen Iterator in des Bereichs [_First, _Last) behandelt wird von angegebenen hash_set.

Beispiel

// 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;
}

Anforderungen

Header: <hash_set>

Namespace: stdext

Siehe auch

Referenz

hash_set Class

Standardvorlagenbibliothek

Last updated on 2013-03-26