length プロパティ (Array)
更新 : 2007 年 11 月
配列内で定義されている最後の要素のインデックスより 1 だけ大きい整数値を示します。
arrayObj.length
引数
- arrayObj
必ず指定します。任意の Array オブジェクトを指定します。
解説
JScript 配列内の要素のインデックスは必ずしも連続している必要はありません。したがって、length プロパティの値が配列内の要素の数と一致するとは限りません。
length プロパティに代入される値が既存の値よりも小さい場合、配列は切り詰められ、length プロパティに新しく設定した値以上のインデックスを持つ要素はすべて失われます。
前回よりも大きい値を length プロパティに設定すると、配列は形式的に拡張されますが、新しい要素は作成されません。
使用例
length プロパティの使用例を次に示します。配列を宣言し、2 つの要素を追加します。配列の最大のインデックスは 6 であるため、length の値は 7 になります。
var my_array : Array = new Array();
my_array[2] = "Test";
my_array[6] = "Another Test";
print(my_array.length); // Prints 7.