Namespaces
Variants

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

From ja.cppreference.net
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
/* 未指定 */ operator [ ] ( difference_type n ) const ;
(constexpr C++17以降)

指定された相対位置にある要素への参照を返します。

目次

パラメータ

n - 現在位置からの相対位置

戻り値

current [ - n - 1 ]

注記

戻り値の型は LWG issue 386 によって未規定に変更されました。これは、基盤となるイテレータの operator [ ] の戻り値の型も当時は未規定だったためです。

しかしながら、 N3066 以降、 LegacyRandomAccessIterator の operator [ ] の戻り値の型は reference に変換可能であることが要求されます。すべての一般的な実装では、戻り値の型は reference として宣言されています。関連項目: LWG issue 2595 。

例

#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]) は 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]) は int&
    std::cout << '\n';
    // constexpr コンテキスト
    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; // コンパイルエラー: 基となるイテレータが
                   // ランダムアクセスイテレータの要件を満たさない
}

出力:

3 2 1 0
3 2 1 0

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

DR 適用対象 公開時の動作 正しい動作
LWG 386 C++98 戻り値の型は reference でした 未指定に変更

関連項目

指し示す要素にアクセスする
(public member function)