命名空间
变体
操作

std::experimental::ranges::SizedSentinel

出自 cppreference.cn
< cpp‎ | experimental‎ | ranges
 
 
实验性
技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
库基础 3 (库基础 TS v3)
并行扩展 (并行 TS)
并行扩展 2 (并行 TS v2)
并发扩展 (并发 TS)
并发扩展 2 (并发 TS v2)
概念 (概念 TS)
范围 (范围 TS)
反射 (反射 TS)
数学特殊函数 (特殊函数 TR)
实验性非 TS
模式匹配
线性代数
std::execution
契约
2D 图形
 
 
迭代器库
迭代器概念
SizedSentinel

间接可调用概念
                                                  
                                                  
                                                  
通用算法要求
                                                  
概念工具
迭代器工具和操作
迭代器 traits
迭代器适配器
流迭代器
 
template< class S, class I >

concept bool SizedSentinel =
    Sentinel<S, I> &&
    !ranges::disable_sized_sentinel<std::remove_cv_t<S>, std::remove_cv_t<I>> &&
    requires(const I& i, const S& s) {
        { s - i } -> Same<ranges::difference_type_t<I>>&&;
        { i - s } -> Same<ranges::difference_type_t<I>>&&;

    };
(1) (ranges TS)
template< class S, class I >
constexpr bool disable_sized_sentinel = false;
(1) (ranges TS)

SizedSentinel 概念指定,迭代器类型 I 的对象和哨兵类型 S 的对象可以相减,以常量时间计算它们之间的距离。

iI 类型的迭代器,sS 类型的哨兵,使得 [is) 表示一个范围。设 N 为使 bool(i == s) 为真的最小 ++i 应用次数。那么 SizedSentinel<S, I> 仅在以下情况下满足:

  • 如果 N 可以用 ranges::difference_type_t<I> 表示,则 s - i 是良定义的且等于 N;并且
  • 如果 -N 可以用 ranges::difference_type_t<I> 表示,则 i - s 是良定义的且等于 -N

变量模板 disable_sized_sentinel 为可以相减但不满足 SizedSentinel 的语义要求的迭代器和哨兵提供了一种机制,通过将变量模板特化为值 true 来选择退出该概念。

[编辑] 等式保持

如果表达式在给定相等输入时产生相等输出,则该表达式是等式保持的。

  • 表达式的输入由其操作数组成。
  • 表达式的输出由其结果和表达式修改的所有操作数(如果有)组成。

每个需要保持等式的表达式还必须是稳定的:在没有对这些输入对象进行显式干预修改的情况下,使用相同的输入对象对这样的表达式进行两次求值必须具有相等的输出。

除非另有说明,否则在requires-expression中使用的每个表达式都必须是等式保持和稳定的,并且表达式的求值可能只会修改其非常量操作数。常量操作数不得修改。

[编辑] 隐式表达式变体

对于某些常量左值操作数是非修改性的表达式,requires-expression 也隐式地要求该表达式的附加变体接受给定操作数的非常量左值或(可能常量)右值,除非明确要求具有不同语义的这种表达式变体。这些隐式表达式变体必须满足声明的表达式的相同语义要求。实现验证变体语法的程度是未指定的。