std::ranges::is_sorted_until
来自 cppreference.cn
                    
                                        
                    
                    
                                                            
                    | 定义于头文件  <algorithm> | ||
| 调用签名 (Call signature) | ||
| template< std::forward_iterator I, std::sentinel_for<I> S,           class Proj = std::identity, | (1) | (C++20 起) | 
| template< std::forward_range R, class Proj = std::identity,           std::indirect_strict_weak_order< | (2) | (C++20 起) | 
检查范围 [first, last) 并找到以 first 开头的最大范围,其中元素按非降序排序。
如果序列的任何迭代器 it 和任何非负整数 n(使得 it + n 是指向序列元素的有效迭代器),std::invoke(comp, std::invoke(proj, *(it + n)), std::invoke(proj, *it)) 计算结果为 false,则该序列相对于比较器 comp 是有序的。
1) 使用给定的二元比较函数 comp 比较元素。
本页描述的类函数实体是 算法函数对象(非正式地称为 niebloids),即
| 目录 | 
[编辑] 参数
| first, last | - | 定义元素范围的迭代器-哨兵对,以查找其有序上限 | 
| r | - | 要查找其有序上限的范围 | 
| comp | - | 应用于投影元素的比较函数 | 
| proj | - | 应用于元素的投影 | 
[编辑] 返回值
以 first 开头的最大范围的上限,其中元素按非降序排序。也就是说,范围 [first, it) 有序的最后一个迭代器 it。
[编辑] 复杂度
与 first 和 last 之间的距离呈线性关系。
[编辑] 可能的实现
| struct is_sorted_until_fn { template<std::forward_iterator I, std::sentinel_for<I> S, class Proj = std::identity, std::indirect_strict_weak_order<std::projected<I, Proj>> Comp = ranges::less> constexpr I operator()(I first, S last, Comp comp = {}, Proj proj = {}) const { if (first == last) return first; for (auto next = first; ++next != last; first = next) if (std::invoke(comp, std::invoke(proj, *next), std::invoke(proj, *first))) return next; return first; } template<ranges::forward_range R, class Proj = std::identity, std::indirect_strict_weak_order< std::projected<ranges::iterator_t<R>, Proj>> Comp = ranges::less> constexpr ranges::borrowed_iterator_t<R> operator()(R&& r, Comp comp = {}, Proj proj = {}) const { return (*this)(ranges::begin(r), ranges::end(r), std::ref(comp), std::ref(proj)); } }; inline constexpr is_sorted_until_fn is_sorted_until; | 
[编辑] 注意
对于空范围和长度为一的范围,ranges::is_sorted_until 返回等于 last 的迭代器。
[编辑] 示例
运行此代码
#include <array> #include <algorithm> #include <iostream> #include <iterator> #include <random> int main() { std::random_device rd; std::mt19937 g {rd()}; std::array nums {3, 1, 4, 1, 5, 9}; constexpr int min_sorted_size = 4; int sorted_size = 0; do { std::ranges::shuffle(nums, g); const auto sorted_end = std::ranges::is_sorted_until(nums); sorted_size = std::ranges::distance(nums.begin(), sorted_end); std::ranges::copy(nums, std::ostream_iterator<int>(std::cout, " ")); std::cout << " : " << sorted_size << " leading sorted element(s)\n"; } while (sorted_size < min_sorted_size); }
可能的输出
4 1 9 5 1 3 : 1 leading sorted element(s) 4 5 9 3 1 1 : 3 leading sorted element(s) 9 3 1 4 5 1 : 1 leading sorted element(s) 1 3 5 4 1 9 : 3 leading sorted element(s) 5 9 1 1 3 4 : 2 leading sorted element(s) 4 9 1 5 1 3 : 2 leading sorted element(s) 1 1 4 9 5 3 : 4 leading sorted element(s)
[编辑] 另请参阅
| (C++20) | 检查一个范围是否按升序排序 (算法函数对象) | 
| (C++11) | 寻找最大的已排序子范围 (函数模板) | 


