次の方法で共有


配列 (C++/CLI および C++/CX)

C++/CX の Platform::Array<T> 型、または C++/CLI の array キーワードは、指定された型と初期値の配列を宣言します。

すべてのプラットフォーム

配列は、宣言内で終わり山かっこ (>) の後ろに、ハンドルへのオブジェクト (^) 修飾子を使用して宣言する必要があります。 配列の要素の数は型の一部ではありません。 1 つの配列変数で、異なるサイズの配列を参照できます。

標準 C++ とは異なり、添字演算はポインターの算術演算と同義ではなく、交換可能ではありません。

配列の詳細については、以下を参照してください。

Windows ランタイム

配列は、Platform 名前空間のメンバーです。 配列は、1 次元のみが可能です。

構文

構文の最初の例では、ref new 集計キーワードを使用して配列を割り当てます。 2 番目の例では、ローカル配列を宣言します。

[qualifiers] [Platform::]Array<[qualifiers] array-type [,rank]>^ identifier =
    ref new[Platform::]Array<initialization-type> [{initialization-list [,...]}]

[qualifiers] [Platform::]Array<[qualifiers] array-type [,rank]>^ identifier =
    {initialization-list [,...]}

qualifiers
(省略可能) 次のストレージ クラス指定子 (1 つ以上): mutablevolatileconstexternstatic

array-type
配列変数の型。 有効な型は、Windows ランタイム クラスと基本型、ref クラスと構造体、値クラスと構造体、およびネイティブ ポインター (type*) です。

rank
(省略可能) 配列の次元の数。 1 にする必要があります。

identifier
配列変数の名前。

initialization-type
配列を初期化する値の型。 通常、array-typeinitialization-type には同じ型を指定します。 ただし、initialization-type から array-type への変換がある場合は、異なる型を指定できます (たとえば initialization-typearray-type から派生する場合)。

initialization-list
(省略可能) 配列の要素を初期化する、中かっこ内のコンマ区切りの値の一覧。 たとえば、rank-size-list(3) の場合 (3 つの要素の 1 次元配列を宣言しています)、initialization-list には {1,2,3} を指定できます。

解説

コンパイル時に、型が __is_ref_array(type) の参照カウント配列かどうかを検出できます。 詳細については、「型の特徴のコンパイラ サポート」を参照してください。

要件

コンパイラ オプション: /ZW

次の例では、100 個の要素がある 1 次元配列を作成します。

// cwr_array.cpp
// compile with: /ZW
using namespace Platform;
ref class MyClass {};
int main() {
   // one-dimensional array
   Array<MyClass^>^ My1DArray = ref new Array<MyClass^>(100);
   My1DArray[99] = ref new MyClass();
}

共通言語ランタイム

構文

構文の最初の例では、gcnew キーワードを使用して配列を割り当てます。 2 番目の例では、ローカル配列を宣言します。

[qualifiers] [cli::]array<[qualifiers] array-type [,rank]>^ identifier =
    gcnew [cli::]array<initialization-type[,rank]>(rank-size-list[,...]) [{initialization-list [,...]}]

[qualifiers] [cli::]array<[qualifiers] array-type [,rank]>^ identifier =
    {initialization-list [,...]}

qualifiers
(省略可能) 次のストレージ クラス指定子 (1 つ以上): mutablevolatileconstexternstatic

array-type
配列変数の型。 有効な型は、Windows ランタイム クラスと基本型、ref クラスと構造体、値クラスと構造体、ネイティブ ポインター (type*)、およびネイティブ POD (Plain Old Data) 型です。

rank
(省略可能) 配列の次元の数。 既定値は 1 です。最大値は 32 です。 配列の各次元そのものが配列です。

identifier
配列変数の名前。

initialization-type
配列を初期化する値の型。 通常、array-typeinitialization-type には同じ型を指定します。 ただし、initialization-type から array-type への変換がある場合は、異なる型を指定できます (たとえば initialization-typearray-type から派生する場合)。

rank-size-list
配列の各次元のサイズのコンマ区切りの一覧。 または、initialization-list パラメーターが指定された場合は、コンパイラが各次元のサイズを推測できるため、rank-size-list は省略できます。

initialization-list
(省略可能) 配列の要素を初期化する、中かっこ内のコンマ区切りの値の一覧。 または、多次元配列の要素を初期化する、入れ子になった initialization-list 項目のコンマ区切りの一覧。

たとえば、rank-size-list(3) の場合 (3 つの要素の 1 次元配列を宣言しています)、initialization-list には {1,2,3} を指定できます。 rank-size-list(3,2,4) の場合 (最初の次元に 3 つの要素、2 番目の次元に 2 つの要素、3 番目の要素に 4 つの要素を宣言しています)、initialization-list には {{1,2,3},{0,0},{-5,10,-21,99}}. を指定できます。

解説

配列は、プラットフォーム、既定、および cli 名前空間 にあります。

標準 C++ 同様、配列のインデックスはゼロから始まり、配列には角かっこ ([]) を使用して添え字を指定します。 標準 C++ とは異なり、多次元配列のインデックスは、各次元に対する一連の角括弧 ([]) ではなく、各次元に対するインデックスの一覧で指定されます。 たとえば、identifier[index1][index2] ではなく、identifier[index1, index2] になります。

すべてのマネージ配列は System::Array から継承します。 配列変数に System::Array の任意のメソッドまたはプロパティを直接適用できます。

要素の型がポインターである配列をマネージ クラスに割り当てると、要素が 0 に初期化されます。

要素の型が V, 型の値である配列を割り当てると、配列の各要素に V 用の既定のコンストラクタが適用されます。 詳細については、「C++ ネイティブ型と等価な .NET Framework ネイティブ型 (C++/CLI)」を参照してください。

コンパイル時に、型が __is_ref_array(type) の共通言語ランタイム (CLR) 配列かどうかを検出できます。 詳細については、「型の特徴のコンパイラ サポート」を参照してください。

要件

コンパイラ オプション: /clr

次の例では、100 個の要素を持つ 1 次元配列と、最初の次元に 3 つの要素、2 番目の次元に 5 つの要素、および 3 番目の次元に 6 つの要素を持つ 3 次元配列を作成します。

// clr_array.cpp
// compile with: /clr
ref class MyClass {};
int main() {
   // one-dimensional array
   array<MyClass ^> ^ My1DArray = gcnew array<MyClass ^>(100);
   My1DArray[99] = gcnew MyClass();

   // three-dimensional array
   array<MyClass ^, 3> ^ My3DArray = gcnew array<MyClass ^, 3>(3, 5, 6);
   My3DArray[0,0,0] = gcnew MyClass();
}

関連項目

.NET および UWP でのコンポーネント拡張