public length : Number

配列内のエレメント数を示す負でない整数。このプロパティは、新しいエレメントが配列に追加されると自動更新されます。例えば、my_array[index] = value を使用してエレメントに値を代入するとき、index が数値でかつ index+1 が length プロパティよりも大きい場合、length プロパティが index+1 に更新されます。

メモ : length プロパティに既存の長さよりも短い値を代入した場合、配列は切り詰められます。

例

次のコードでは、length プロパティがどのように更新されるかを示します。最初の長さが 0 で、1、2、および 10 に更新されます。length プロパティに既存の長さよりも短い値を代入した場合、配列は切り詰められます。

var my_array:Array = new Array(); 
trace(my_array.length); // 最初の長さは 0 です
my_array[0] = "a";
trace(my_array.length); // my_array.length は 1 に更新されます。
my_array[1] = "b";
trace(my_array.length); // my_array.length は 2 に更新されます。
my_array[9] = "c";
trace(my_array.length); // my_array.length は 10 に更新されます。
trace(my_array); 
// 表示: 
// a,b,undefined,undefined,undefined,undefined,undefined,undefined,undefined,c

// length プロパティが 5 に設定されている場合、配列は切り詰められます。
my_array.length = 5; 
trace(my_array.length); // my_array.length は 5 に更新されます。
trace(my_array); // 出力: a,b,undefined,undefined,undefined