length プロパティ (arguments)

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

関数を呼び出すときに実際に渡された引数の数を返します。

[function.]arguments.length

引数

function
省略可能です。現在実行中の Function オブジェクトの名前を指定します。

解説

arguments オブジェクトの length プロパティは、スクリプトエンジンによって、関数が実行されるときにオブジェクトに渡される引数の実際の数に初期化されます。

使用例

arguments オブジェクトの length プロパティの使用例を次に示します。

function argTest(a, b) : String {
   var i : int;
   var s : String = "The argTest function expected ";
   var numargs : int = arguments.length; // Get number of arguments passed.
   var expargs : int = argTest.length;   // Get number of arguments expected.
   if (expargs < 2)
      s += expargs + " argument. ";
   else
      s += expargs + " arguments. ";
   if (numargs < 2)
      s += numargs + " was passed.";
   else
      s += numargs + " were passed.";
   s += "\n"
   for (i =0 ; i < numargs; i++){        // Get argument contents.
      s += "  Arg " + i + " = " + arguments[i] + "\n";
   }
   return(s);                            // Return list of arguments.
}

print(argTest(42));
print(argTest(new Date(1999,8,7),"Sam",Math.PI));

/fast- オプションを指定してコンパイルすると、このプログラムの出力は次のようになります。

The argTest function expected 2 arguments. 1 was passed.
  Arg 0 = 42

The argTest function expected 2 arguments. 3 were passed.
  Arg 0 = Tue Sep 7 00:00:00 PDT 1999
  Arg 1 = Sam
  Arg 2 = 3.141592653589793