std::experimental::ranges::find_end

定义于头文件 `<experimental/ranges/algorithm>` 中
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) 中搜索序列 [first2, last2) 的最后一次出现（在使用 proj 进行投影后）。

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) 中序列 [first2, last2) 的最后一次出现的开始位置的迭代器（在使用 proj 进行投影后）。

如果 [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;
}

[编辑] 示例

[编辑] 另请参阅

find_end	在特定范围内查找元素的最后一个序列 (函数模板) [编辑]
search	搜索元素范围 (函数模板) [编辑]
includes	如果一个集合是另一个集合的子集，则返回true (函数模板) [编辑]
adjacent_find	查找第一个相等的两个相邻项（或满足给定谓词的项） (函数模板) [编辑]
findfind_iffind_if_not	查找满足特定条件的第一个元素 (函数模板) [编辑]
find_first_of	搜索一组元素中的任何一个 (函数模板) [编辑]
search_n	在一个范围内搜索元素的连续副本 (函数模板) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
库基础 3 (库基础 TS v3)
并行扩展 (并行 TS)
并行扩展 2 (并行 TS v2)
并发扩展 (并发 TS)
并发扩展 2 (并发 TS v2)
概念 (概念 TS)
范围 (范围 TS)
反射 (反射 TS)
数学特殊函数 (特殊函数 TR)
实验性非 TS
模式匹配
线性代数
std::execution
契约
2D 图形

cppreference.com

命名空间

变体

视图

操作