C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- std::begin, std::cbegin
- std::end, std::cend
- std::next
- std::reverse_iterator
- std::rbegin, std::crbegin
- std::indirectly_readable
- std::indirectly_writable
- std::weakly_incrementable
- std::prev
- std::move_iterator
- std::size, std::ssize
- std::empty
- std::data
- std::insert_iterator
- std::rend, std::crend
- std::incrementable
- std::input_or_output_iterator
- std::sentinel_for
- std::sized_sentinel_for, std::disable_sized_sentinel_for
- std::input_iterator
- std::output_iterator
- std::forward_iterator
- std::bidirectional_iterator
- std::random_access_iterator
- std::contiguous_iterator
- std::iterator_traits
- std::input_iterator_tag, std::output_iterator_tag, std::forward_iterator_tag, std::bidirectional_iterator_tag, std::random_access_iterator_tag, std::contiguous_iterator_tag
- std::iterator
- std::incrementable_traits
- std::indirectly_readable_traits
- std::iter_value_t, std::iter_reference_t, std::iter_difference_t, std::iter_rvalue_reference_t, std::iter_common_reference_t
- std::indirect_unary_invocable, std::indirectly_regular_unary_invocable
- std::indirect_unary_predicate
- std::indirect_binary_predicate
- std::indirect_equivalence_relation
- std::indirect_strict_weak_order
- std::indirectly_movable
- std::indirectly_movable_storable
- std::indirectly_copyable
- std::indirectly_copyable_storable
- std::indirectly_swappable
- std::indirectly_comparable
- std::permutable
- std::mergeable
- std::sortable
- std::indirect_result_t
- std::projected
- std::move_sentinel
- std::back_insert_iterator
- std::front_insert_iterator
- std::make_reverse_iterator
- std::make_move_iterator
- std::default_sentinel_t, std::default_sentinel
- std::unreachable_sentinel_t, std::unreachable_sentinel
- std::back_inserter
- std::front_inserter
- std::inserter
- std::istream_iterator
- std::ostream_iterator
- std::istreambuf_iterator
- std::ostreambuf_iterator
- std::advance
- std::distance
- 注释
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::sized_sentinel_for, std::disable_sized_sentinel_for
concept sized_sentinel_for =
std::sentinel_for<S, I> &&
!std::disable_sized_sentinel_for<std::remove_cv_t<S>, std::remove_cv_t<I>> &&
requires(const I& i, const S& s) {
{ s - i } -> std::same_as<std::iter_difference_t<I>>;
{ i - s } -> std::same_as<std::iter_difference_t<I>>;
inline constexpr disable_sized_sentinel_for = false;
sized_sentinel_for
概念指定能在常数时间内相减迭代器类型 I
的对象和哨位类型 S
的对象,计算其间的距离。disable_sized_sentinel_for
变量模板能用于阻止能相减但不实际实现 sized_sentinel_for
的迭代器与哨位满足该概念。允许对 cv 无限定的非数组对象类型
S
与 I
特化该变量模板,只要其中之一是程序定义类型。这种特化必须可用于常量表达式并拥有 const bool 类型。语义要求
令 i
为 I
类型迭代器,而 s
为 S
类型哨位,使得 [i, s)
代表范围。令 n
为需要应用 ++i
以令 bool(i == s) 为 true
的最小次数。则 sized_sentinel_for<S, I>
仅若符合下列条件才得到实现:
- 若
n
能以 ranges::difference_type_t<I> 表示,则 s - i 良定义并等于n
;且 - 若
-n
能以 ranges::difference_type_t<I> 表示,则 i - s 良定义并等于-n
。 -
i
与s
间的减法拥有常数时间复杂度。
相等性保持
若表达式对给定的相等输入产生相等输出,则它保持相等性。
- 表达式的输入由其操作数组成。
- 表达式的输出由其结果和表达式所修改的所有操作数(若存在)组成。
在标准概念的规范中,操作数定义为仅包含下列内容的最大子表达式:
- 标识表达式,及
- 对 std::move 、 std::forward 与 std::declval 的调用。
每个操作数的 cv 限定与值类别,是通过假设每个模板类型形参代表一个 cv 无限定的非数组对象类型确定的。
进一步要求每个要求保持相等性的表达式都稳定:这种表达式带相同输入对象的二次求值必须拥有相等的输出,而无任何对这些输入对象的显式中间修改。
除非另外提醒,每个用于 requires 表达式中的表达式都要求保持相等性且稳定,而表达式的求值必须只修改其非常操作数。必须不修改常操作数。
隐式表达式变种
使用不修改某 const 左值运算数的表达式的 requires 表达式亦隐式要求该表达式的额外变种对给定运算数接受非 const 左值或(可为 const 的)右值,除非以有区别的语义显式要求这种表达式变种。这些隐式表达式变种必须符合与声明的表达式的相同的语义。不指定实现以何种程度校验变种的语法。