命名空间
变体
操作

std::experimental::ranges::find_end

来自 cppreference.cn
< cpp‎ | experimental‎ | ranges
 
 
实验性
技术规范
文件系统库 (filesystem TS)
库基础 (library fundamentals TS)
库基础 2 (library fundamentals TS v2)
库基础 3 (library fundamentals TS v3)
并行扩展 (parallelism TS)
并行扩展 2 (parallelism TS v2)
并发扩展 (concurrency TS)
并发扩展 2 (concurrency TS v2)
概念 (concepts TS)
范围 (ranges TS)
反射 (reflection TS)
数学特殊函数 (special functions 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) (ranges 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) (ranges TS)
1) 在范围 [first1last1) 中搜索序列 [first2last2) 的最后一次出现(在使用 proj 投影后)。
2)(1) 相同,但使用 r1 作为第一个源范围,r2 作为第二个源范围,如同使用 ranges::begin(r1) 作为 first1ranges::end(r1) 作为 last1ranges::begin(r2) 作为 first2,以及 ranges::end(r2) 作为 last2

尽管上面描述了声明,但算法声明的模板参数的实际数量和顺序是未指定的。因此,如果在调用算法时使用显式模板参数,则程序可能不具有可移植性。

内容

[编辑] 参数

first1, last1 - 要检查的元素范围
r1 - 要检查的元素范围
first2, last2 - 要搜索的元素范围
r2 - 要搜索的元素范围
pred - 用于比较元素的谓词
proj - 要应用于第一个范围中元素的投影

[编辑] 返回值

指向范围 [first1last1) 中序列 [first2last2) 最后一次出现的起始迭代器(在使用 proj 投影后)。

如果 [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
(函数模板) [编辑]
查找前两个相邻的相等项(或满足给定谓词的项)
(函数模板) [编辑]
查找满足特定条件的第一个元素
(函数模板) [编辑]
搜索元素集合中的任何一个
(函数模板) [编辑]
在范围内搜索元素的若干个连续副本
(函数模板) [编辑]