length (Array.length プロパティ)

配列内のエレメント数を示す負でない整数。このプロパティは、新しいエレメントが配列に追加されると自動更新されます。配列エレメントに値を代入するとき (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); // 最初の 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 property プロパティが 5 に設定されると、配列が切り詰められる
my_array.length = 5; 
trace(my_array.length); // my_array.length が 5 に更新される
trace(my_array); // a,b,undefined,undefined,undefined を出力する