length プロパティ (Array オブジェクト)

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

numVar = arrayObj.length 

引数

  • numVar
    必ず指定します。任意の変数を指定します。
  • arrayObj
    必ず指定します。Array オブジェクトの名前を指定します。

解説

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

var my_array = new Array( );
my_array[0] = "テスト";
my_array[6] = "別のテスト";

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

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

次のコードは、length プロパティの使用例です。

function LengthDemo(){
   var a;
   a = new Array(0,1,2,3,4);
   return(a.length);
}

必要条件

バージョン 2

参照

length プロパティ (Function オブジェクト) | length プロパティ (String オブジェクト)

対象: Array オブジェクト