std::experimental::ranges::find_end

出自cppreference.com
 
C++
 
實驗性
技術規範
文件系統庫 (文件系統 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) 搜索範圍 [first1, last1)（以 proj 投射後）最後一次出現的序列 [first2, last2)。
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 - 運用於第一範圍中元素的投射

返回值

指向範圍 [first1, last1)（經過 proj 投射後）最後出現的序列 [first2, last2) 的開頭的迭代器。

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

複雜度

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

註解

僅對範圍 [first1, last1) 運用投射。

可能的實現

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
(函數模板) [編輯]
尋找頭兩個相等（或滿足給定謂詞）的相鄰項
(函數模板) [編輯]
尋找首個滿足特定判別標準的元素
(函數模板) [編輯]
搜索元素集中的任何元素
(函數模板) [編輯]
在範圍中搜索一定量的某個元素的連續副本
(函數模板) [編輯]