命名空间
变体
操作

std::ranges::crend

来自 cppreference.com
< cpp‎ | ranges
 
 
范围库
范围适配器
 
在头文件 <ranges> 中定义
在头文件 <iterator> 中定义
inline namespace /* 未指定 */ {

    inline constexpr /* 未指定 */ crend = /* 未指定 */;

}
(自 C++20 起)
(定制点对象)
调用签名
template< class T >

    requires /* 见下文 */

constexpr /* 见下文 */ auto crend( T&& t );
(自 C++20 起)

返回一个哨兵 用于常量迭代器(自 C++23 起),指示被视为反向序列的const 限定的(直到 C++23)范围的末尾。

range-rbegin-rend.svg

CT

ranges::crend 的调用与 ranges::rend(static_cast<CT&&>(t)) 表达式等效。

(直到 C++23)

如果参数是左值或 ranges::enable_borrowed_range<std::remove_cv_t<T>>true,则对 ranges::crend 的调用与以下表达式等效

在所有其他情况下,对 ranges::crend 的调用是非法的,这会导致在模板实例化的直接上下文中出现调用时,替换失败

(自 C++23 起)

如果 ranges::crend(e) 对于表达式 e 有效,其中 decltype((e))T,则 CT 符合 std::ranges::range,并且(直到 C++23) std::sentinel_for<S, I> 在所有情况下都为 true,其中 Sdecltype(ranges::crend(e)),而 Idecltype(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 符合

否则,__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++14)
返回容器或数组的反向结束迭代器
(函数模板) [编辑]