multiset::find
Retourne un itérateur adressant le premier emplacement d'un élément dans un multiensemble 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é de correspondance par la clé de tri d'un élément de multiensemble recherché.
Valeur de retour
iterator ou const_iterator qui traite le premier emplacement d'un élément avec une clé spécifiée, ou l'emplacement réussissant le dernier élément dans le multiensemble 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 multiensemble dont 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 multiensemble ne peut pas être modifié.Si la valeur de retour de find est assignée à iterator, l'objet de multiensemble peut être modifié.
Exemple
// multiset_find.cpp
// compile with: /EHsc
#include <set>
#include <iostream>
int main( )
{
using namespace std;
multiset <int> ms1;
multiset <int> :: const_iterator ms1_AcIter, ms1_RcIter;
ms1.insert( 10 );
ms1.insert( 20 );
ms1.insert( 20 );
ms1_RcIter = ms1.find( 20 );
cout << "The first element of multiset ms1 with a key of 20 is: "
<< *ms1_RcIter << "." << endl;
ms1_RcIter = ms1.find( 40 );
// If no match is found for the key, end( ) is returned
if ( ms1_RcIter == ms1.end( ) )
cout << "The multiset ms1 doesn't have an element "
<< "with a key of 40." << endl;
else
cout << "The element of multiset ms1 with a key of 40 is: "
<< *ms1_RcIter << "." << endl;
// The element at a specific location in the multiset can be
// found using a dereferenced iterator addressing the location
ms1_AcIter = ms1.end( );
ms1_AcIter--;
ms1_RcIter = ms1.find( *ms1_AcIter );
cout << "The first element of ms1 with a key matching" << endl
<< "that of the last element is: "
<< *ms1_RcIter << "." << endl;
// Note that the first element with a key equal to
// the key of the last element is not the last element
if ( ms1_RcIter == --ms1.end( ) )
cout << "This is the last element of multiset ms1."
<< endl;
else
cout << "This is not the last element of multiset ms1."
<< endl;
}
Configuration requise
en-tête : <set>
l'espace de noms : DST