std::experimental::ranges::find_end

從 cppreference.com
< cpp‎ | experimental‎ | ranges
 
 
實驗性
技術規範
文件系統庫 (文件系統 TS)
庫基礎 (庫基礎 TS)
庫基礎 2 (庫基礎 TS v2)
庫基礎 3 (庫基礎 TS v3)
並行擴展 (並行 TS)
並行擴展 2 (並行 TS v2)
並發擴展 (並發 TS)
並發擴展 2 (並發 TS v2)
概念 (概念 TS)
範圍 (範圍 TS)
反射 (反射 TS)
數學特殊函數 (特殊函數 TR)
實驗性非 TS 功能特性
模式匹配
線性代數
std::execution
契約
2D 圖形
 
 
 
template< ForwardIterator I1, Sentinel<I1> S1, ForwardIterator I2, Sentinel<I2> S2,

          class Proj = ranges::identity,
          IndirectRelation<I2, projected<I1, Proj>> Pred = ranges::equal_to<> >
I1 find_end( I1 first1, S1 last1, I2 first2, S2 last2,

             Pred pred = Pred{}, Proj proj = Proj{} );
(1) (範圍 TS)
template< ForwardRange R1, ForwardRange R2, class Proj = ranges::identity,

          IndirectRelation<ranges::iterator_t<R2>,
                           projected<ranges::iterator_t<R1>, Proj>> Pred = ranges::equal_to<> >
ranges::safe_iterator_t<R1> find_end( Rng1&& rng1, Rng2&& rng2,

                                      Pred pred = Pred{}, Proj proj = Proj{} );
(2) (範圍 TS)
1) 搜索範圍 [first1last1)(以 proj 投射後)最後一次出現的序列 [first2last2)
2)(1) 相同,但用 r1 為第一源範圍並用 r2 為第二源範圍,如同以 ranges::begin(r1)first1,以 ranges::end(r1)last1,以 ranges::begin(r2)first2,並以 ranges::end(r2)last2

儘管聲明描述如上,算法聲明的模板形參的實際數量和順序是未指定的。從而若在調用算法時使用顯式模板實參,則程序很可能不可移植。

目錄

[編輯] 參數

first1, last1 - 要檢驗的元素範圍
r1 - 要檢驗的元素範圍
first2, last2 - 要搜索的元素範圍
r2 - 要搜索的元素範圍
pred - 用於比較元素的謂詞
proj - 運用於第一範圍中元素的投射

[編輯] 返回值

指向範圍 [first1last1)(經過 proj 投射後)最後出現的序列 [first2last2) 的開頭的迭代器。

如果 [first2last2) 為空或如果未找到這種序列,則返回與 last1 比較相等的迭代器。

[編輯] 複雜度

最多 S * (N - S + 1) 次運用謂詞和投射,其中 S = last2 - first2N = last1 - first1

[編輯] 註解

僅對範圍 [first1last1) 運用投射。

[編輯] 可能的實現

template<ForwardIterator I1, Sentinel<I1> S1, ForwardIterator I2, Sentinel<I2> S2,
         class Proj = ranges::identity,
         IndirectRelation<I2, projected<I1, Proj>> Pred = ranges::equal_to<>>
I1 find_end(I1 first1, S1 last1, I2 first2, S2 last2,
            Pred pred = Pred{}, Proj proj = Proj{})
{
    I1 result = ranges::next(first1, last1);
    if (first2 == last2)
        return result;
    while (true)
    {
        I1 new_result = ranges::search(first1, last1, first2, last2, pred, proj);
        if (new_result == last1)
            break;
        else
        {
            result = new_result;
            first1 = result;
            ++first1;
        }
    }
    return result;
}

[編輯] 示例

[編輯] 參閱

查找元素序列在特定範圍中最後一次出現
(函數模板) [編輯]
搜索一個元素範圍
(函數模板) [編輯]
若一個集合是另一個的子集則返回 true
(函數模板) [編輯]
尋找頭兩個相等(或滿足給定謂詞)的相鄰項
(函數模板) [編輯]
尋找首個滿足特定判別標準的元素
(函數模板) [編輯]
搜索元素集中的任何元素
(函數模板) [編輯]
在範圍中搜索一定量的某個元素的連續副本
(函數模板) [編輯]