Namespaces
Variants

std::array<T,N>:: operator[]

From cppreference.net

C++
Containers library
std::array
reference operator [ ] ( size_type pos ) ;
(1) (C++11以降)
(C++17以降constexpr)
const_reference operator [ ] ( size_type pos ) const ;
(2) (C++11以降)
(C++14以降constexpr)

指定された位置 pos の要素への参照を返します。

pos < size() が false の場合、動作は未定義です。

(C++26まで)

pos < size() が false の場合：

  • 実装が ハードニング されている場合、 契約違反 が発生します。さらに、契約違反ハンドラが「observe」評価セマンティクスの下で戻った場合、動作は未定義です。
  • 実装がハードニングされていない場合、動作は未定義です。
(C++26以降)

目次

パラメータ

pos - 返される要素の位置

戻り値

要求された要素への参照。

計算量

定数。

注記

std::map::operator[] とは異なり、この演算子はコンテナに新しい要素を挿入することはありません。この演算子を通じて存在しない要素にアクセスすることは未定義動作です （実装が強化されている場合を除く） (C++26以降) 。

例

以下のコードは operator [ ] を使用して std:: array < int , N > の読み書きを行います：

このコードを実行 
#include <array>
#include <iostream>
int main()
{
    std::array<int, 4> numbers{2, 4, 6, 8};
    std::cout << "Second element: " << numbers[1] << '\n';
    numbers[0] = 5;
    std::cout << "All numbers:";
    for (auto i : numbers)
        std::cout << ' ' << i;
    std::cout << '\n';
}

出力： 

Second element: 4
All numbers: 5 4 6 8

関連項目

境界チェック付きで指定された要素にアクセス
(公開メンバ関数)