Namespaces
Variants

    std::experimental::ranges:: search_n

    From ja.cppreference.net
    C++
    Experimental
    Ranges
    Algorithms library
    Non-modifying sequence operations
    Modifying sequence operations
    Partitioning operations
    Sorting operations
    Binary search operations
    Set operations (on sorted ranges)
    Heap operations
    Minimum/maximum operations
    Permutations
    ヘッダーで定義 <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)
    1) 範囲 [ first , last ) 内で、述語 pred によって射影された値がそれぞれ指定された値 value に等しい、最初の count 個の要素からなる連続したシーケンスを検索します。
    2) (1) と同じですが、 r をソース範囲として使用します。これは ranges:: begin ( r ) を first として、 ranges:: end ( r ) を last として使用する場合と同様です。

    目次

    パラメータ

    first, last - 検査する要素の範囲
    r - 検査する要素の範囲
    count - 検索するシーケンスの長さ
    value - 検索する値
    pred - 射影された要素と value を比較する述語
    proj - 要素に適用する射影

    戻り値

    範囲 [ first , last ) 内で見つかったシーケンスの先頭を指すイテレータ。 そのようなシーケンスが見つからない場合は、 last と等価なイテレータが返されます。

    計算量

    最大で last - first 回の述語と射影の適用。

    実装例 

    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{})
{
    for (; first != last; ++first)
    {
        if (!ranges::invoke(pred, ranges::invoke(proj, *first), value))
            continue;
        I candidate = first;
        ranges::difference_type_t<I> cur_count = 0;
        while (true)
        {
            ++cur_count;
            if (cur_count == count)
                // 成功
                return candidate;
            ++first;
            if (first == last)
                // リストを走査し尽くした
                return first;
            if (!ranges::invoke(pred, ranges::invoke(proj, *first), value))
                // 連続する要素数が不足
                break;
        }
    {
    return first;
}

    例

    このセクションは不完全です
    理由: 例がありません

    関連項目

    		 範囲内で、ある要素の連続する複数個のコピーが最初に現れる位置を検索する
    (関数テンプレート & アルゴリズム関数オブジェクト)
    (C++20)
    		特定の範囲内で、要素の最後の並びを検索する
    (関数テンプレート)
    		特定の条件を満たす最初の要素を検索する
    (関数テンプレート)
    		要素の範囲を検索する
    (関数テンプレート)