public Array([value:Object])

配列を作成できます。コンストラクタを使用して各種の配列を作成できます。たとえば、空の配列や、長さのみが指定されておりエレメントの値が定義されていない配列のほか、エレメントが特定の値を持つ配列などがあります。

シンタックス 1 : パラメータを指定しない場合は、長さが 0 の配列が作成されます。

シンタックス 2 : 長さのみを指定した場合は、length で指定した数のエレメントを持つ配列が作成されます。各エレメントの値は undefined に設定されます。

シンタックス 3 : element パラメータを使って値を指定した場合は、特定の値を持つ配列が作成されます。

パラメータ

value:Object (オプション) - 次のいずれか :

• 配列内のエレメント数を指定する整数。
• 複数の任意の値で構成されるリスト。値として使用できる型は、Boolean、Number、String、Object、Array です。配列内の第 1 のエレメントのインデックス番号は常に 0 です。

メモ : Array コンストラクタに 1 つの数値パラメータのみが渡されると、そのパラメータは length と見なされ、Integer() 関数を使用して整数に変換されます。

例

シンタックス 1 : 次の例では、初期のエレメント数が 0 個の新しい Array オブジェクトを作成します。

var my_array:Array = new Array(); 
trace(my_array.length); // 0 をトレースします。

シンタックス 2 : 次の例では、初期のエレメント数が 4 個の新しい Array オブジェクトを作成します。

var my_array:Array = new Array(4);
trace(my_array.length); // 4 を返します。
trace(my_array[0]); // undefined を返します。
if (my_array[0] == undefined) { // undefined に引用符はつけません。
    trace("undefined は特別な値です。ストリングではありません。");
} // トレース: undefined は特別な値です。ストリングではありません。

シンタックス 3 : 次の例では、初期のエレメント数が 5 個の新しい Array オブジェクト go_gos_array を作成します。

var go_gos_array:Array = new Array("Belinda", "Gina", "Kathy", "Charlotte", "Jane");
trace(go_gos_array.length); // 5 を返します。
trace(go_gos_array.join(", ")); // エレメントを表示します。

配列 go_gos_array の初期エレメントを次のように指定します。

go_gos_array[0] = "Belinda";
go_gos_array[1] = "Gina";
go_gos_array[2] = "Kathy";
go_gos_array[3] = "Charlotte";
go_gos_array[4] = "Jane";

次のコードでは、配列 go_gos_array に 6 番目のエレメントを追加し、2 番目のエレメントを変更します。

go_gos_array[5] = "Donna";
go_gos_array[1] = "Nina"
trace(go_gos_array.join(" + "));
// Belinda + Nina + Kathy + Charlotte + Jane + Donna を返します。

関連項目

[] 配列アクセス演算子, length (Array.length プロパティ)