std::reverse_iterator<Iter>::operator[]

/* unspecified */ operator[]( difference_type n ) const;		(до C++17)
constexpr /* unspecified */ operator[]( difference_type n ) const;		(с C++17)

Возвращает ссылку на элемент в указанном относительном местоположении.

Параметры

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

Значение возврата

Ссылка на элемент в относительном местоположении, то есть base()[-n - 1].

Примечания

Тип возвращаемого значения был изменён по LWG386 на неопределённый, так как тип возвращаемого значения для оператора [] базового итератора также был неопределённым в то время. Однако, начиная с N3066, тип возвращаемого значения для оператора [] LegacyRandomAccessIterator должен быть преобразуем в ссылку. Во всех распространённых реализациях тип возвращаемого значения для reverse_iterator::operator[] объявлен как ссылка. См. также LWG2595.

Пример

#include <array>
#include <cstddef>
#include <iostream>
#include <iterator>
#include <list>
#include <vector>
 
int main()
{
    int a[]{0, 1, 2, 3};
    std::reverse_iterator<int*> iter1{std::rbegin(a)};
    for (std::size_t i{}; i != std::size(a); ++i)
        std::cout << iter1[i] << ' '; // decltype(iter1[i]) is `int&`
    std::cout << '\n';
 
    std::vector v{0, 1, 2, 3};
    std::reverse_iterator<std::vector<int>::iterator> iter2{std::rbegin(v)};
    for (std::size_t i{}; i != std::size(v); ++i)
        std::cout << iter2[i] << ' '; // decltype(iter2[i]) is `int&`
    std::cout << '\n';
 
    // constexpr context
    constexpr static std::array<int, 4> z{0, 1, 2, 3};
    constexpr std::reverse_iterator<decltype(z)::const_iterator> iter3{std::crbegin(z)};
    static_assert(iter3[1] == 2);
 
    std::list li{0, 1, 2, 3};
    std::reverse_iterator<std::list<int>::iterator> iter4{std::rbegin(li)};
    *iter4 = 42;   // OK
//  iter4[0] = 13; // compilation error: the underlying iterator
                   // does not model the random access iterator
}

Вывод:

3 2 1 0
3 2 1 0

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применён к	Поведение, как опубликовано	Правильное поведение
LWG 386	C++98	тип возвращаемого значения был `reference`	сделан неопределённым

См. также

operator*operator->

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

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