名前空間
変種
操作

std::experimental::ranges::search_n

From cppreference.com
< cpp‎ | experimental‎ | ranges
 
 
 
 
 
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) 範囲[firstlast)において、指定された値valueと、述語predに従ってそれぞれ等しい要素のシーケンスをcount個探します。
2) (1) と同じですが、ソース範囲として r を使用し、ranges::begin(r)firstranges::end(r)last として使用するかのようです。

目次

[編集] パラメータ

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

[編集] 返り値

範囲[firstlast)で見つかったシーケンスの先頭を指すイテレータ。そのようなシーケンスが見つからなかった場合は、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)
                // success
                return candidate;
 
            ++first;
            if (first == last)
                // exhausted the list
                return first;
 
            if (!ranges::invoke(pred, ranges::invoke(proj, *first), value))
                // too few in a row
                break;
        }
    }
    return first;
}

[編集]

[編集] 関連項目

範囲内である要素が連続して出現する最初の箇所を検索する
(関数テンプレート) [編集]
特定の範囲内で最後の要素のシーケンスを見つける
(function template) [編集]
特定の基準を満たす最初の要素を見つける
(function template) [編集]
要素の範囲を検索します。
(function template) [編集]
English 日本語 中文(简体) 中文(繁體)