std::counted_iterator<I>::operator[]

来自cppreference.com
 
C++
 
迭代器库
迭代器概念
迭代器原语
算法概念与工具
间接可调用概念
常用算法要求
(C++20)
(C++20)
(C++20)
工具
(C++20)
迭代器适配器
范围访问
(C++11)(C++14)
(C++14)(C++14)  
(C++11)(C++14)
(C++14)(C++14)  
(C++17)(C++20)
(C++17)
(C++17)
 
std::counted_iterator
 
constexpr decltype(auto) operator[]( std::iter_difference_t<I> n ) const
    requires std::random_access_iterator<I>;
(C++20 起)

访问位于指定相对位置的元素。

如果 count() > n 是 false，那么行为未定义。

(C++26 前)

如果 count() > n 是 false，那么：

  • 如果实现是硬化实现，那么就会发生契约违背。
  • 如果实现不是硬化实现，那么行为未定义。
 (C++26 起)

参数

n - 相对当前位置的位移

返回值

base()[n]

示例

运行此代码
#include <array>
#include <iostream>
#include <iterator>
#include <list>

int main()
{
    std::array array{'A', 'B', 'C', 'D', 'E'};
    
    std::counted_iterator it{array.begin() + 1, /*count:*/ 3};
    
    for (int i{}; i != it.count(); ++i)
        std::cout << it[i] << ' ';
    std::cout << '\n';
    
    for (int i{}; i != it.count(); ++i)
        it[i] += ('E' - 'A');
    
    for (int i{}; i != it.count(); ++i)
        std::cout << it[i] << ' ';
    std::cout << '\n';
    
    std::list list{'X', 'Y', 'Z', 'W'};
    std::counted_iterator it2{list.begin(), 3};
//  char x = it2[0]; // 错误：不满足要求 `random_access_iterator`
    std::cout << *it2 << '\n'; // OK
}

输出： 

B C D
F G H
X

参阅

 访问被指向的元素
(公开成员函数) [编辑]