std::ranges::crend
在头文件 <ranges> 中定义 |
||
在头文件 <iterator> 中定义 |
||
inline namespace /* 未指定 */ { inline constexpr /* 未指定 */ crend = /* 未指定 */; |
(自 C++20 起) (定制点对象) |
|
调用签名 |
||
template< class T > requires /* 见下文 */ |
(自 C++20 起) | |
返回一个哨兵 用于常量迭代器(自 C++23 起),指示被视为反向序列的const 限定的(直到 C++23)范围的末尾。
设
对 |
(直到 C++23) |
如果参数是左值或 ranges::enable_borrowed_range<std::remove_cv_t<T>> 是 true,则对
在所有其他情况下,对 |
(自 C++23 起) |
如果 ranges::crend(e) 对于表达式 e 有效,其中 decltype((e)) 是 T
,则 CT
符合 std::ranges::range,并且(直到 C++23) std::sentinel_for<S, I> 在所有情况下都为 true,其中 S
是 decltype(ranges::crend(e)),而 I
是 decltype(ranges::crbegin(e))。 此外,如果 S
符合 input_iterator
,则 S
符合 常量迭代器
。(自 C++23 起)
定制点对象
名称 ranges::crend
表示一个定制点对象,它是一个常量 函数对象,其类型为 字面量 semiregular
类类型。为了说明,其类型的 cv 无限定版本表示为 __crend_fn
。
所有 __crend_fn
实例都是相等的。无论表示实例的表达式是左值还是右值,以及是否进行 const 限定(但是,不需要调用 volatile 限定的实例),在相同参数上调用不同 __crend_fn
类型的实例所产生的效果是等效的。因此,可以自由复制 ranges::crend
,并且可以使用其副本进行互换。
给定一组类型 Args...
,如果 std::declval<Args>()... 满足上述对 ranges::crend
参数的要求,则 __crend_fn
符合
- std::invocable<__crend_fn, Args...>,
- std::invocable<const __crend_fn, Args...>,
- std::invocable<__crend_fn&, Args...>,以及
- std::invocable<const __crend_fn&, Args...>.
否则,__crend_fn
的任何函数调用运算符都不会参与重载解析。
[编辑] 示例
#include <algorithm> #include <iostream> #include <iterator> #include <vector> int main() { int a[]{4, 6, -3, 9, 10}; std::cout << "Array backwards: "; namespace ranges = std::ranges; ranges::copy(ranges::rbegin(a), ranges::rend(a), std::ostream_iterator<int>(std::cout, " ")); std::cout << '\n'; std::cout << "Vector backwards: "; std::vector v{4, 6, -3, 9, 10}; ranges::copy(ranges::rbegin(v), ranges::rend(v), std::ostream_iterator<int>(std::cout, " ")); std::cout << '\n'; }
输出
Array backwards: 10 9 -3 6 4 Vector backwards: 10 9 -3 6 4
[编辑] 另请参见
(C++20) |
返回范围的反向结束迭代器 (定制点对象) |
(C++14) |
返回容器或数组的反向结束迭代器 (函数模板) |