The function search_n is used to search for a number of consecutive elements with the same properties.
template<class ForwardIterator, class Size, class T> ForwardIterator search_n (ForwardIterator first, ForwardIterator last, Size count, const T& value); template<class ForwardIterator, class Size, class T, class BinaryPredicate> ForwardIterator search_n (ForwardIterator first, ForwardIterator last, Size count, const T& value, BinaryPredicate pred);
An iterator to the first occurrence is returned or last1 is returned if no criteria is met.