std::array - cppreference.com

<tbody> </tbody>

std::array は固定サイズの配列をカプセル化するコンテナです。

このコンテナは C スタイルの配列 T[N] を唯一の非 static データメンバとして保持する構造体と同じセマンティクスを持つ集成体型です。 C スタイルの配列と異なり、自動的に T* に格下げしません。 集成体型と同様に、 T に変換可能な最大 N 個の初期化子を指定した集成体初期化で初期化することができます (例: std::array<int, 3> a = {1,2,3};)。

この構造体は C スタイルの配列の性能やアクセス性と標準コンテナの利点 (自身のサイズの把握、代入のサポート、ランダムアクセスイテレータなど) を併せ持ちます。

std::array は、 Container および ReversibleContainer の要件をデフォルト構築された array が空でないことと swap の計算量が線形時間であることを除いて満たし、 ContiguousContainer の要件を満たし、 (C++17以上) SequenceContainer の要件を部分的に満たします。

array には長さゼロ (N == 0) のための特別なケースがあります。 このケースでは、 array.begin() == array.end() となり、その値は何らかの一意な値になります。 サイズ0の array に対する front() と back() の呼び出しの効果は未定義です。

array は同じ型の N 個の要素を持つタプルとしても使うことができます。

イテレータの無効化

ルールとして、 array へのイテレータはその array の生存期間を通して無効になることは決してありません。 しかし、 swap した場合にイテレータが同じ array の要素を指し続け、そのためその値が変更される、ということには気を付けるべきです。

メンバ型

メンバ関数

非メンバ関数

ヘルパークラス

推定ガイド(C++17以上)

例

#include <string>
#include <iterator>
#include <iostream>
#include <algorithm>
#include <array>

int main()
{
    // 構築は集成体初期化を使用します。
    std::array<int, 3> a1{ {1, 2, 3} }; // CWG 1270 の改訂前の C++11 では二重の波括弧が必要です
                                        // (改定後の C++11 および C++14 以上では必要ありません)。
    std::array<int, 3> a2 = {1, 2, 3};  // = の後では必要ありません。
    std::array<std::string, 2> a3 = { std::string("a"), "b" };

    // コンテナ操作がサポートされています。
    std::sort(a1.begin(), a1.end());
    std::reverse_copy(a2.begin(), a2.end(), 
                      std::ostream_iterator<int>(std::cout, " "));

    std::cout << '\n';
    
    // 範囲 for ループがサポートされています。
    for(const auto& s: a3)
        std::cout << s << ' ';
}

関連項目