機能

配列内で定義されている最後の要素のインデックスより 1 だけ大きい整数値。

構文

numVar = arrayObj.length;

解説

配列内の要素のインデックスは必ずしも連続している必要はありません。したがって、length プロパティの値が配列内の要素の数と一致するとは限りません。たとえば、次のような配列を定義したとします。

var my_array = new Array( );
my_array[0] = "Test";
my_array[6] = "Another Test";

この場合、my_array.length の値は、2 ではなく 7 になります。

値の代入前に格納されていたよりも小さい値を length プロパティに代入すると、配列は切り詰められ、length プロパティに新しく設定した値以上のインデックスを持つ要素はすべて失われます。

代入前に格納されていたよりも大きい値を length プロパティに代入すると、配列は拡張されます。新しく作成された要素の値は、Undefined になります。