| Defined in header <experimental/ranges/algorithm>
|
||
| template< ForwardIterator I, Sentinel<I> S, class T, class Pred = ranges::equal_to<>, class Proj = ranges::identity > requires IndirectlyComparable<I, const T*, Pred, Proj> I search_n( I first, S last, ranges::difference_type_t<I> count, const T& value, Pred pred = Pred{}, Proj proj = Proj{} ); |
(1) | (ranges TS) |
| template< ForwardRange R, class T, class Pred = ranges::equal_to<>, class Proj = ranges::identity > requires IndirectlyComparable<ranges::iterator_t<R>, const T*, Pred, Proj> ranges::safe_iterator_t<R> search_n( R&& r, ranges::difference_type_t<ranges::iterator_t<R>> count, const T& value, Pred pred = Pred{}, Proj proj = Proj{} ); |
(2) | (ranges TS) |
[first, last) for the first sequence of count elements whose projected values are each equal to the given value value according to the predicate pred.r as the source range, as if using ranges::begin(r) as first and ranges::end(r) as last.Parameters
| first, last | - | the range of elements to examine |
| r | - | the range of elements to examine |
| count | - | the length of the sequence to search for |
| value | - | the value to search for |
| pred | - | the predicate that compares the projected elements with value
|
| proj | - | the projection to apply to the elements |
Return value
Iterator to the beginning of the found sequence in the range [first, last). If no such sequence is found, an iterator that compares equal to last is returned.
Complexity
At most last - first applications of the predicate and the projection.
Possible implementation
|
Example
Reason: no example
See also
| searches for the first occurrence of a number consecutive copies of an element in a range (function template) | |
| finds the last sequence of elements in a certain range (function template) | |
| finds the first element satisfying specific criteria (function template) | |
| searches for a range of elements (function template) |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.