map::find
Gibt einen Iterator zurück, der die Position eines Elements in einer Zuordnung behandelt, die 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 der Zuordnung gefunden werden, Schlüsselwert, die gesucht wird.
Rückgabewert
Ein Iterator, der die Position eines Elements mit einem angegebenen Schlüssel behandelt oder der Speicherort, der dem letzten Element mit der Zuordnung folgt, wenn keine Übereinstimmung für die Schlüssel gefunden wird.
Hinweise
Die Memberfunktion gibt einen Iterator zurück, der ein Element in der Zuordnung abweicht, deren Sortierschlüssel zum Argumentschlüssel unter einem binären Prädikat entspricht, das eine Reihenfolge auf Grundlage weniger als Vergleichbarkeitsbeziehung verursacht.
Wenn const_iterator der Rückgabewert von find zugewiesen wird, kann das Zuordnungsobjekt nicht geändert werden.Wenn Iterator der Rückgabewert von find zugewiesen wird, kann das Zuordnungsobjekt geändert werden
Beispiel
// map_find.cpp
// compile with: /EHsc
#include <map>
#include <iostream>
int main( )
{
using namespace std;
map <int, int> m1;
map <int, int> :: const_iterator m1_AcIter, m1_RcIter;
typedef pair <int, int> Int_Pair;
m1.insert ( Int_Pair ( 1, 10 ) );
m1.insert ( Int_Pair ( 2, 20 ) );
m1.insert ( Int_Pair ( 3, 30 ) );
m1_RcIter = m1.find( 2 );
cout << "The element of map m1 with a key of 2 is: "
<< m1_RcIter -> second << "." << endl;
// If no match is found for the key, end( ) is returned
m1_RcIter = m1.find( 4 );
if ( m1_RcIter == m1.end( ) )
cout << "The map m1 doesn't have an element "
<< "with a key of 4." << endl;
else
cout << "The element of map m1 with a key of 4 is: "
<< m1_RcIter -> second << "." << endl;
// The element at a specific location in the map can be found
// using a dereferenced iterator addressing the location
m1_AcIter = m1.end( );
m1_AcIter--;
m1_RcIter = m1.find( m1_AcIter -> first );
cout << "The element of m1 with a key matching "
<< "that of the last element is: "
<< m1_RcIter -> second << "." << endl;
}
Anforderungen
Header: <map>
Namespace: std