namespace std {
  template <class T, std::size_t N>
  struct array;
}

概要

arrayは固定長のオブジェクトを保持するシーケンスコンテナで、各要素は連続して格納される。従来のCスタイルの配列のパフォーマンスを保ったまま、シーケンスのサイズの取得、要素の代入のサポートなど、標準コンテナの恩恵を受ける事ができる。また、境界チェック（範囲外の要素にアクセスしようとしていないかのチェック）付きの要素アクセスもサポートしている。

arrayは、デフォルトコンストラクタで構築されたarrayオブジェクトが空でない点と、swap()の計算量が定数時間でない点を除いて、コンテナとリバーシブルコンテナの全ての要件を満たす。

テンプレートパラメータは、以下を意味する：

• T : 配列の要素型
• N : 配列の要素数。0以上であること

概念・前提知識

• コンテナとは

メンバ関数

構築／破棄

要素へのアクセス

イテレータ

領域

コンテナの変更

メンバ型

非メンバ関数

配列作成関数

推論補助

タプルインタフェースサポート

例

#include <iostream>
#include <array>
#include <algorithm>

int main()
{
  // 3要素のint型配列を定義し、初期化子リストで初期化
  std::array<int, 3> ar = {3, 1, 4};

  // size()メンバ関数による要素数取得
  for (std::size_t i = 0; i < ar.size(); ++i) {
    ++ar[i]; // operator[]で任意の要素にランダムアクセス
  }

  // イテレータによる要素の横断
  std::for_each(ar.begin(), ar.end(), [](int x) {
    std::cout << x << std::endl;
  });
}

出力

4
2
5

バージョン

言語

• C++11

処理系

• Clang: 9.0.1 ✅
• GCC: 4.7.0 ✅
• Visual C++: 2008 (std::tr1) ✅, 2010 ✅, 2012 ✅

関連項目

• C++14 宣言時のメンバ初期化を持つ型の集成体初期化を許可

参照

• LWG Issue 1306. pointer and const_pointer for <array>
  • C++11で、メンバ型pointerとconst_pointerが追加された。ほかのコンテナには定義されていたが、記載が漏れていた
• LWG Issue 2310. Public exposition only member in std::array
  • C++17で、arrayが集成体であることを示す説明専用メンバ（elems）がpublicである旨が明確化され、data()の規定がaddressof(front())を用いる形に整理された
• LWG Issue 2590. Aggregate initialization for std::array
  • C++17で、arrayがコピーリスト初期化に限らず集成体初期化一般で初期化できることが明確化された（std::array<int, 1> a{0};のような直接波カッコ初期化も適格）