命名空间
变体
操作

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 图形
 
 
迭代器库
迭代器概念
间接可调用概念
                                                  
                                                  
                                                  
常用算法要求
                                                  
概念工具
迭代器工具与操作
迭代器特征
迭代器适配器
流迭代器
 
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 的哨兵对象可以相减,以常数时间计算它们之间的距离。

i 为类型为 I 的迭代器,s 为类型为 S 的哨兵,使得 [is) 表示一个范围。令 N 为使 bool(i == s) 为 true 所需的 ++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` 对某个常量左值操作数使用非修改表达式,它也会隐式地要求该表达式的其他变体,这些变体接受非常量左值或(可能是常量的)右值作为给定操作数,除非明确要求具有不同语义的此类表达式变体。这些 *隐式表达式变体* 必须满足与声明表达式相同的语义要求。实现验证这些变体语法的程度是未指定的。