std:: array

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

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

この構造体は、Cスタイル配列のパフォーマンスとアクセシビリティを、標準コンテナの利点（自身のサイズを認識する機能、代入のサポート、ランダムアクセスイテレータなど）と組み合わせています。

std::array は、 Container および ReversibleContainer の要件を満たしますが、デフォルト構築されたarrayは空ではなく、交換の計算量が線形である点が例外です。 また、 ContiguousContainer の要件を満たし、 (C++17以降) SequenceContainer の要件を部分的に満たします。

長さゼロの配列には特別なケースがあります（ N == 0 ）。その場合、 array. begin ( ) == array. end ( ) が成り立ち、これは何らかのユニークな値となります。長さゼロの配列に対して front ( ) または back ( ) を呼び出す効果は未定義です。

配列は同じ型の N 個の要素からなるタプルとしても使用できます。

イテレータの無効化

原則として、配列に対するイテレータは配列のライフタイム全体を通じて無効化されることはありません。ただし、 swap の実行中、イテレータは同じ配列要素を指し続けるため、その値が変化することに注意すべきです。

テンプレートパラメータ

メンバー型

メンバー関数

非メンバー関数

ヘルパークラス

例

#include <algorithm>
#include <array>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    // 構築には集成体初期化を使用
    std::array<int, 3> a1{{1, 2, 3}}; // C++11ではCWG 1270改訂前は二重波括弧が必要
                                      //（改訂後のC++11およびC++14以降では不要）
    std::array<int, 3> a2 = {1, 2, 3}; // = の後では二重波括弧は常に不要
    // コンテナ操作がサポートされている
    std::sort(a1.begin(), a1.end());
    std::ranges::reverse_copy(a2, std::ostream_iterator<int>(std::cout, " "));
    std::cout << '\n';
    // 範囲ベースforループがサポートされている
    std::array<std::string, 2> a3{"E", "\u018E"};
    for (const auto& s : a3)
        std::cout << s << ' ';
    std::cout << '\n';
    // 配列作成のための推論ガイド（C++17以降）
    [[maybe_unused]] std::array a4{3.0, 1.0, 4.0}; // std::array<double, 3>
    // 未指定要素の動作は組み込み配列と同じ
    [[maybe_unused]] std::array<int, 2> a5; // リスト初期化なし、a5[0]とa5[1]は
                                            // デフォルト初期化される
    [[maybe_unused]] std::array<int, 2> a6{}; // リスト初期化、両要素は値初期化され、
                                              // a6[0] = a6[1] = 0
    [[maybe_unused]] std::array<int, 2> a7{1}; // リスト初期化、未指定要素は値初期化され、
                                               // a7[0] = 1, a7[1] = 0
}

3 2 1
E Ǝ

関連項目