Array(): Array Array(numElements:Number): Array Array( [element0:Object
[, element1, element2, ...elementN] ]) : Array

長さが 0 以上の新しい配列、または指定したエレメントのリスト (各種データ型など) により格納される配列を作成します。

次のいずれかを作成することができます。

• 空の配列
• 長さのみが指定されておりエレメント値が定義されていない配列
• エレメントが特定の値を持つ配列

この関数は、Array コンストラクタを使用して配列を作成するのに似ています。Array クラスのコンストラクタを参照してください。

エレメントの数 (numElements)、または複数の異なる種類を含むエレメントリスト (element0, element1, ... elementN) を渡すことができます。

複数のデータ型を指定できるパラメータは、シグネチャで Object としてリストされます。

パラメータ

numElements (オプション) - 配列内のエレメント数を指定する正の整数。numElements またはエレメントリストのいずれかを指定できます。両方を指定することはできません。

elementN [オプション] - 1 つ以上のパラメータ (element0, element1, ..., elementN)。任意のデータ型の値を指定できます。複数のデータ型を指定できるパラメータは、Object としてリストされます。numElements またはエレメントリストのいずれかを指定できます。両方を指定することはできません。

戻り値

Array - 配列。

例

var myArray:Array = Array();
myArray.push(12);
trace(myArray); //12 をトレースします。
myArray[4] = 7;
trace(myArray); //12,undefined,undefined,undefined,7 をトレースします。

シンタックス 2 : 次の例では、エレメントを定義せずに、長さ 4 の配列を作成します。

var myArray:Array = Array(4);
trace(myArray.length); // 4 をトレースします。
trace(myArray); //undefined,undefined,undefined,undefined をトレースします。

シンタックス 3 : 次の例では、3 つのエレメントが定義された配列を作成します。

var myArray:Array = Array("firstElement", "secondElement", "thirdElement");
trace (myArray); //firstElement,secondElement,thirdElement をトレースします。

関連項目

Array