find (<algorithm>)
Sucht die Position des ersten Vorkommens eines Elements in einem Bereich, der einen angegebenen Wert enthält.
template<class InputIterator, class Type>
InputIterator find(
InputIterator _First,
InputIterator _Last,
const Type& _Val
);
Parameter
_First
Ein Eingabeiterator, der die Position des ersten Elements im Bereich abweicht, für den angegebenen Wert gefunden werden._Last
Ein Eingabeiterator, der die Position eine hinter dem letzten Element im Bereich abweicht, für den angegebenen Wert gefunden werden._Val
Der gesucht werden, Wert.
Rückgabewert
Ein Eingabeiterator, der das erste Vorkommen des angegebenen Werts im Bereich gefunden wird bearbeitet.Wenn kein solcher Wert im Bereich vorhanden ist, wird der zurückgegebene Iterator an die letzte Position des Bereichs, eine hinter dem letzten Element.
Hinweise
operator==, das verwendet wird, um die Übereinstimmung zwischen einem Element und dem angegebenen Wert zu ermitteln, muss eine Äquivalenzrelation zwischen den Operanden verlangen.
Beispiel
// 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.
Anforderungen
Header: <algorithm>
Namespace: std