set::find
Retourne un itérateur adressant l'emplacement d'un élément dans un jeu 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 clé d'argument à comparer par la clé de tri d'un élément du jeu recherché.
Valeur de retour
Un itérateur ou const_iterator qui traite l'emplacement d'un élément équivalent à une clé spécifiée ou qui traite l'emplacement réussissant le dernier élément de la valeur 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 jeu dont la clé de tri est équivalente à la clé d'argument sous un attribut binaire qui induit trier en fonction est inférieur à la relation de comparabilité.
Si la valeur de retour de find est assignée à const_iterator, l'objet de positionnement ne peut pas être modifié.Si la valeur de retour de find est assignée à iterator, l'objet de positionnement peut être modifié.
Exemple
// 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;
}
Configuration requise
en-tête : <set>
l'espace de noms : DST