std::ranges::cend
定义在头文件 <ranges> 中 |
||
定义在头文件 <iterator> 中 |
||
inline namespace /* 未指定 */ { inline constexpr /* 未指定 */ cend = /* 未指定 */; |
(自 C++20 起) (自定义点对象) |
|
调用签名 |
||
template< class T > requires /* 见下文 */ |
(自 C++20 起) | |
返回一个哨兵 用于常量迭代器(自 C++23 起) 指示常量范围的结束。
令
对 |
(直到 C++23) |
如果参数是左值或 ranges::enable_borrowed_range<std::remove_cv_t<T>> 为 true,则对
在所有其他情况下,对 |
(自 C++23 起) |
如果 ranges::cend(e) 对表达式 e 有效,其中 decltype((e)) 为 T
,那么 CT
符合 std::ranges::range,并且(直到 C++23) std::sentinel_for<S, I> 在所有情况下都为 true,其中 S
为 decltype(ranges::cend(e)),而 I
为 decltype(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
符合
- std::invocable<__cend_fn, Args...>,
- std::invocable<const __cend_fn, Args...>,
- std::invocable<__cend_fn&, Args...>, 以及
- std::invocable<const __cend_fn&, Args...>.
否则,__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++20) |
返回一个表示范围结尾的哨兵 (定制点对象) |
(C++11)(C++14) |
返回指向容器或数组结尾的迭代器 (函数模板) |