find

find

template<class InIt, class T>
    InIt find(InIt first, InIt last, const T& val);

The template function determines the lowest value of N in the range [0, last - first) for which the predicate *(first + N) == val is true. It then returns first + N. If no such value exists, the function returns last. It evaluates the predicate once, at most, for each N.

See the related sample program.