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

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)

Параметры

позиция относительно текущего положения

Возвращаемое значение

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]; // Error: requirement `random_access_iterator` was not satisfied.
    std::cout << *it2 << '\n'; // OK
}

Вывод:

B C D
F G H
X

См. также

operator*operator->

обращается к элементу, на который указывает итератор
(открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/iterator/counted_iterator/operator_at