std::experimental::ranges::find_end
来自 cppreference.cn
< cpp | experimental | ranges
template< ForwardIterator I1, Sentinel<I1> S1, ForwardIterator I2, Sentinel<I2> S2, class Proj = ranges::identity, |
(1) | (ranges TS) |
template< ForwardRange R1, ForwardRange R2, class Proj = ranges::identity, IndirectRelation<ranges::iterator_t<R2>, |
(2) | (ranges 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; } |
[编辑] 示例
本节不完整 原因:没有示例 |
[编辑] 参见
在某个范围内查找最后一个元素序列 (函数模板) | |
搜索元素范围 (函数模板) | |
如果一个集合是另一个集合的子集,则返回 true (函数模板) | |
查找前两个相邻的相等项(或满足给定谓词的项) (函数模板) | |
查找满足特定条件的第一个元素 (函数模板) | |
搜索元素集合中的任何一个 (函数模板) | |
在范围内搜索元素的若干个连续副本 (函数模板) |