map::find
Retourne un itérateur adressant l'emplacement d'un élément dans un mappage qui a une clé équivalente à une clé spécifiée.
iterator find(
const Key& _Key
);
const_iterator find(
const Key& _Key
) const;
Paramètres
- _Key
La valeur de clé de correspondance par la clé de tri d'un élément de la carte qui est trouvée.
Valeur de retour
Un itérateur qui traite l'emplacement d'un élément avec une clé spécifiée, ou l'emplacement réussissant le dernier élément dans le mappage si aucune correspondance n'est trouvée pour la clé.
Notes
La fonction membre retourne un itérateur qui traite un élément dans le mappage de la clé de tri est équivalente à la clé d'argument sous un attribut binaire qui induit le classement de moins que la relation de comparabilité.
Si la valeur de retour de find est assignée à const_iterator, l'objet de mappage ne peut pas être modifié.Si la valeur de retour de find est assignée à iterator, l'objet de mappage peut être modifié
Exemple
// 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;
}
Configuration requise
en-tête : <map>
l'espace de noms : DST