set::find

Gibt einen Iterator zurück, der die Position eines Elements in einem Satz behandelt, der eine Schlüsselentsprechung zu einem angegebenen Schlüssel verfügt.

iterator find(
   const Key& _Key
);
const_iterator find(
   const Key& _Key
) const;

Parameter

  • _Key
    Der durch den Sortierschlüssel eines Elements aus dem Satz gefunden werden, Argumentschlüssel, der gefunden wird.

Rückgabewert

Ein Iterator oder const_iterator, der den Speicherort einer Elemententsprechung zu einem angegebenen Schlüssel abweicht, oder den Speicherort der abweicht, der dem letzten Element mit dem Satz folgt, wenn keine Übereinstimmung für die Schlüssel gefunden wird.

Hinweise

Die Memberfunktion gibt einen Iterator zurück, der ein Element im Satz anspricht, dessen Sortierschlüssel zum Argumentschlüssel unter einem binären Prädikat entspricht, das eine Reihenfolge auf Grundlage einer weniger-als Vergleichbarkeitsbeziehung verursacht.

Wenn const_iterator der Rückgabewert von find zugewiesen wird, ist das angegebene Objekt nicht geändert werden.Wenn Iterator der Rückgabewert von find zugewiesen wird, ist das angegebene Objekt geändert werden.

Beispiel

// set_find.cpp
// compile with: /EHsc
#include <set>
#include <iostream>

int main( )
{
   using namespace std;
   set <int> s1;
   set <int> :: const_iterator s1_AcIter, s1_RcIter;
   
   s1.insert( 10 );
   s1.insert( 20 );
   s1.insert( 30 );

   s1_RcIter = s1.find( 20 );
   cout << "The element of set s1 with a key of 20 is: "
        << *s1_RcIter << "." << endl;

   s1_RcIter = s1.find( 40 );

   // If no match is found for the key, end( ) is returned
   if ( s1_RcIter == s1.end( ) )
      cout << "The set s1 doesn't have an element "
           << "with a key of 40." << endl;
   else
      cout << "The element of set s1 with a key of 40 is: "
           << *s1_RcIter << "." << endl;

   // The element at a specific location in the set can be found 
   // by using a dereferenced iterator addressing the location
   s1_AcIter = s1.end( );
   s1_AcIter--;
   s1_RcIter = s1.find( *s1_AcIter );
   cout << "The element of s1 with a key matching "
        << "that of the last element is: "
        << *s1_RcIter << "." << endl;
}
  
  
  

Anforderungen

Header: <set>

Namespace: std

Siehe auch

Referenz

set Class

set::find (STL Samples)

Standardvorlagenbibliothek