Namespaces
Variants

std:: get (std::array)

From cppreference.net
C++
Containers library
std::array
ヘッダーで定義 <array>
template < std:: size_t I, class T, std:: size_t N >
T & get ( std:: array < T,N > & a ) noexcept ;
(1) (C++11以降)
(constexprはC++14以降)
template < std:: size_t I, class T, std:: size_t N >
T && get ( std:: array < T,N > && a ) noexcept ;
(2) (C++11以降)
(constexprはC++14以降)
template < std:: size_t I, class T, std:: size_t N >
const T & get ( const std:: array < T,N > & a ) noexcept ;
(3) (C++11以降)
(constexprはC++14以降)
template < std:: size_t I, class T, std:: size_t N >
const T && get ( const std:: array < T,N > && a ) noexcept ;
(4) (C++11以降)
(constexprはC++14以降)

I th 要素を配列から抽出します（ tuple-like インターフェースを使用）。

I は範囲 [ ​ 0 ​ , N ) 内の整数値でなければなりません。これは at() や operator[] とは異なり、コンパイル時に強制されます。

目次

パラメータ

a - 内容を抽出する配列

戻り値

I th 要素への参照 a 。

計算量

定数。

例

このコードを実行 
#include <array>
#include <iostream>
constexpr std::array v{1, 2, 3};
static_assert(get<0>(v) == 1 && get<1>(v) == 2 && get<2>(v) == 3);
int main()
{
    std::array<int, 3> a;
    // 値の設定:
    get<0>(a) = 1, get<1>(a) = 2, get<2>(a) = 3;
    // 値の取得:
    std::cout << '(' << get<0>(a) << ',' << get<1>(a) << ',' << get<2>(a) << ")\n";
}

出力: 

(1,2,3)

欠陥報告

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

DR 適用対象 公開時の動作 正しい動作
LWG 2485 C++11 there are no overloads for const array&& the overloads are added

関連項目

構造化バインディング (C++17) 指定された名前を初期化子のサブオブジェクトまたはタプル要素にバインドする
指定された要素にアクセスする
(公開メンバ関数)
境界チェック付きで指定された要素にアクセスする
(公開メンバ関数)
(C++11)
タプルの指定された要素にアクセスする
(関数テンプレート)
(C++11)
pair の要素にアクセスする
(関数テンプレート)
(C++17)
インデックスまたは型（型が一意の場合）を指定してvariantの値を読み取り、エラー時には例外をスローする
(関数テンプレート)
(C++20)
std::ranges::subrange からイテレータまたはセンチネルを取得する
(関数テンプレート)
(C++26)
std::complex から実部または虚部への参照を取得する
(関数テンプレート)