Array コンストラクタ

public Array([value: Object])

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

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

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

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

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

パラメータ

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

メモ : 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 is a special value, not a string");
} // undefined is a special value, not a string をトレースする

シンタックス 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 プロパティ)