Array コンストラクタ

public Array([value: Object ])

配列を作成できます。コンストラクタを使用して、さまざまなタイプの配列を作成できます。たとえば、空の配列、長さだけが指定されてエレメント値が定義されない配列、またはエレメントが特定の値を持つ配列などが可能です。

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

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

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

対応バージョン : ActionScript 1.0、Flash Player 5

パラメータ

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

配列内のエレメント数を指定する整数
任意の 1 つまたは複数の値で構成されるリスト。値として使用できる型は、ブール値、数値、ストリング、オブジェクト、配列です。配列内の第 1 のエレメントのインデックス番号は常に 0 です。

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

例

シンタックス 1: 次の例では、初期の長さが 0 である新しい Array オブジェクトを作成します。

var my_array:Array = new Array();
trace(my_array.length); // Traces 0.

シンタックス 2: 次の例では、初期の長さが 4 である新しい Array オブジェクトを作成します。

var my_array:Array = new Array(4);
trace(my_array.length); // Returns 4.
trace(my_array[0]); // Returns undefined.
if (my_array[0] == undefined) { // No quotation marks around undefined.
    trace("undefined is a special value, not a string");
} // Traces: 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); // Returns 5.
trace(go_gos_array.join(", ")); // Displays elements.

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(" + "));
// Returns Belinda + Nina + Kathy + Charlotte + Jane + Donna.

Array コンストラクタ

パラメータ

例

関連項目