search

The function search is used to search for the first occurrence of a sub-range that meets the criteria.

  template<class ForwardIterator1, class ForwardIterator2>
  ForwardIterator1 search
  (ForwardIterator1 first1, ForwardIterator1 last1,
  ForwardIterator2 first2, ForwardIterator2 last2);
  template<class ForwardIterator1, 
  class ForwardIterator2,class BinaryPredicate>
  ForwardIterator1 search
  (ForwardIterator1 first1, ForwardIterator1 last1,
  ForwardIterator2 first2, ForwardIterator2 last2, 
  BinaryPredicate pred);
  
Remarks

An iterator to the first occurrence is returned or last1 is returned if no criteria is met.