find (<algorithm>)
Individuare la posizione della prima occorrenza di un elemento in un intervallo con un valore specificato.
template<class InputIterator, class Type>
InputIterator find(
InputIterator _First,
InputIterator _Last,
const Type& _Val
);
Parametri
_First
Un iteratore di input destinato alla posizione del primo elemento nell'intervallo da cercare il valore specificato._Last
Un iteratore di input destinato alla posizione una dopo l'elemento finale nell'intervallo da cercare il valore specificato._Val
Il valore da cercare.
Valore restituito
Un iteratore di input per la prima occorrenza del valore specificato nell'intervallo trovato.Se tale valore è presente nell'intervallo, un iteratore restituito è destinato all'ultima posizione di intervallo, una dopo l'elemento finale.
Note
operator== utilizzato per determinare la corrispondenza tra un elemento e il valore specificato è necessario imporre una relazione di equivalenza fra i propri operandi.
Esempio
// alg_find.cpp
// compile with: /EHsc
#include <list>
#include <algorithm>
#include <iostream>
int main() {
using namespace std;
list <int> L;
list <int>::iterator Iter;
list <int>::iterator result;
L.push_back( 40 );
L.push_back( 20 );
L.push_back( 10 );
L.push_back( 30 );
L.push_back( 10 );
cout << "L = ( " ;
for ( Iter = L.begin( ) ; Iter != L.end( ) ; Iter++ )
cout << *Iter << " ";
cout << ")" << endl;
result = find( L.begin( ), L.end( ), 10 );
if ( result == L.end( ) )
cout << "There is no 10 in list L.";
else {
cout << "There is a 10 in list L";
if ( ++result != L.end() )
cout << " and it is followed by a " << *result << ".";
}
cout << endl;
}
Output
L = ( 40 20 10 30 10 )
There is a 10 in list L and it is followed by a 30.
Requisiti
intestazione: <algorithm>
Spazio dei nomi: deviazione standard