std::experimental::ranges::RandomAccessIterator

来自cppreference.com
< cpp‎ | experimental‎ | ranges
 
 
技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
库基础 3 (库基础 TS v3)
并行扩展 (并行 TS)
并行扩展 2 (并行 TS v2)
并发扩展 (并发 TS)
并发扩展 2 (并发 TS v2)
概念 (概念 TS)
范围 (范围 TS)
反射 (反射 TS)
数学特殊函数 (特殊函数 TR)
 
 
迭代器库
迭代器概念
间接可调用概念
                                                  
                                                  
                                                  
常用算法要求
                                                  
概念工具
迭代器工具及运算
迭代器特性
迭代器适配器
流迭代器
 
定义于头文件 <experimental/ranges/iterator>
template <class I>

concept bool RandomAccessIterator =
  ranges::BidirectionalIterator<I> &&
  ranges::DerivedFrom<
    ranges::iterator_category_t<I>, ranges::random_access_iterator_tag
  > &&
  ranges::StrictTotallyOrdered<I> &&
  ranges::SizedSentinel<I, I> &&
  requires(I i, const I j, const ranges::difference_type_t<I> n) {
    { i += n } -> ranges::Same<I>&;
    { j + n }  -> ranges::Same<I>&&;
    { n + j }  -> ranges::Same<I>&&;
    { i -= n } -> ranges::Same<I>&;
    { j - n }  -> ranges::Same<I>&&;
    j[n];
    requires ranges::Same<decltype(j[n]), ranges::reference_t<I>>;

  };
(范围 TS)

概念 RandomAccessIterator<I> 细化 BidirectionalIterator ,添加用 +=-=+- 运算符的常数时间前进、用 - 的常数时间距离计算,及带下标的数组记法支持。

abI 类型的合法迭代器,使得从 a 可抵达 b ,并令 n 为等于 b - aranges::difference_type_t<I> 类型值。 RandomAccessIterator<I> 仅若符合下列条件才得到满足:

  • (a += n) 等于 b
  • std::addressof(a += n) 等于 std::addressof(a)
  • (a + n) 等于 (a += n)
  • (a + n) 等于 (n + a)
  • 对于任何二个正整数 xy ,若 a + (x + y) 合法,则 a + (x + y) 等于 (a + x) + y
  • a + 0 等于 a
  • (a + (n - 1)) 合法,则 --b 等于 (a + (n - 1))
  • (b += -n)(b -= n) 都等于 a
  • std::addressof(b -= n) 等于 std::addressof(b)
  • (b - n) 等于 (b -= n)
  • b 可解引用,则 a[n] 合法并等于 *b
  • bool(a <= b)true

相等性保持

若表达式对给定的相等输入产生相等输出,则它保持相等性

  • 表达式的输入由其运算数组成。
  • 表达式的输出由其结果和表达式所修改的所有运算数(若存在)组成。

进一步要求每个要求保持相等性的表达式都稳定:这种表达式带相同输入对象的二次求值必须拥有相等的输出,而无任何对这些输入对象的显式中间修改。

除非另外提醒,每个用于 requires 表达式中的表达式都要求保持相等性且稳定,而表达式的求值必须只修改其非常运算数。必须不修改常运算数。

隐式表达式变种

使用不修改某 const 左值运算数的表达式的 requires 表达式亦隐式要求该表达式的额外变种对给定运算数接受非 const 左值或(可为 const 的)右值,除非以有区别的语义显式要求这种表达式变种。这些隐式表达式变种必须符合与声明的表达式的相同的语义。不指定实现以何种程度校验变种的语法。