命名空间
变体
操作

std::ranges::cend

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

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

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

    requires /* 见下文 */

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

返回一个哨兵 用于常量迭代器(自 C++23 起) 指示常量范围的结束。

range-begin-end.svg

CT

ranges::cend 的调用与 ranges::end(static_cast<CT&&>(t)) 相当。

(直到 C++23)

如果参数是左值或 ranges::enable_borrowed_range<std::remove_cv_t<T>>true,则对 ranges::cend 的调用与

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

(自 C++23 起)

如果 ranges::cend(e) 对表达式 e 有效,其中 decltype((e))T,那么 CT 符合 std::ranges::range,并且(直到 C++23) std::sentinel_for<S, I> 在所有情况下都为 true,其中 Sdecltype(ranges::cend(e)),而 Idecltype(ranges::cbegin(e))此外,如果 S 符合 input_iterator,则 S 符合 constant-iterator(自 C++23 起)

自定义点对象

名称 ranges::cend 表示一个自定义点对象,它是一个 const 函数对象,属于 字面量 semiregular 类类型。为了说明目的,其类型的 cv 无限定版本表示为 __cend_fn

所有 __cend_fn 实例都相等。在相同参数上调用不同 __cend_fn 类型实例的效果是等效的,无论表示该实例的表达式是左值还是右值,以及是否为 const 限定(但是,不要求 volatile 限定实例可调用)。因此,可以自由地复制 ranges::cend,并且可以互换使用其副本。

给定一组类型 Args...,如果 std::declval<Args>()... 满足上面 ranges::cend 参数的要求,则 __cend_fn 符合

否则,__cend_fn 的任何函数调用运算符都不会参与重载解析。

[编辑] 示例

#include <algorithm>
#include <cassert>
#include <ranges>
#include <vector>
 
int main()
{
    std::vector vec{3, 1, 4};
    int arr[]{5, 10, 15};
 
    assert(std::ranges::find(vec, 5) == std::ranges::cend(vec));
    assert(std::ranges::find(arr, 5) != std::ranges::cend(arr));
}

[编辑] 参见

返回一个表示范围结尾的哨兵
(定制点对象)[编辑]
(C++11)(C++14)
返回指向容器或数组结尾的迭代器
(函数模板) [编辑]