find (STL)
Sucht die Position des ersten Vorkommens eines Elements in einem Bereich, der einen angegebenen Wert enthält.
template<class InputIterator, class T> InputIterator find(InputIterator first, InputIterator last, const T& val);
Parameter
first
Ein Eingabeiterator, der die Position des ersten Elements im nach dem angegebenen Wert zu durchsuchenden Bereich adressiert.last
Ein Eingabeiterator, der die Position eine Stelle hinter dem letzten Element im nach dem angegebenen Wert zu durchsuchenden Bereich adressiert.val
Der zu suchende Wert.
Rückgabewert
Ein Eingabeiterator, der das erste Vorkommen des angegebenen Werts im zu durchsuchenden Bereich adressiert. Wenn kein Element mit einem äquivalenten Wert gefunden wird, wird last zurückgegeben.
Hinweise
Der zur Bestimmung des Gleichheitszustands zwischen einem Element und dem angegebenen Wert verwendete operator== muss eine Äquivalenzrelation zwischen zwei Operanden vorgeben.
Ein Codebeispiel mit find() finden Sie unter find_if.
Anforderungen
Header: <algorithm>
Namespace: std