std::experimental::ranges::find_end
来自cppreference.com
< cpp | experimental | ranges
| template< ForwardIterator I1, Sentinel<I1> S1, ForwardIterator I2, Sentinel<I2> S2, class Proj = ranges::identity, |
(1) | (范围 TS) |
| template< ForwardRange R1, ForwardRange R2, class Proj = ranges::identity, IndirectRelation<ranges::iterator_t<R2>, |
(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 (函数模板) | |
| 寻找头两个相等（或满足给定谓词）的相邻项 (函数模板) | |
| 寻找首个满足特定判别标准的元素 (函数模板) | |
| 搜索元素集中的任何元素 (函数模板) | |
| 在范围中搜索一定量的某个元素的连续副本 (函数模板) |