Math.hypot()

概要

引数の二乗和の平方根を返します。すなわち

$$\mathtt{\operatorname{Math.hypot}(v_1, v_2, \dots, v_n)} = \sqrt{\sum_{i=1}^n v_i^2} = \sqrt{v_1^2 + v_2^2 + \dots + v_n^2}$$

構文

Math.hypot([value1[, value2[, ...]]])

引数

value1, value2, ...

数値

説明

hypot()はMathオブジェクトの静的なメソッドなので、自ら生成したMathオブジェクトのメソッドとしてではなく、常に、Math.hypot()として使用するようにしてください(Mathオブジェクトにはコンストラクタがありません)。

引数が与えられないなら、結果は+0となります。

少なくとも引数のうち１つが数値に変換できないなら、結果はNaNになります。

ひとつの引数では、Math.hypot()はMath.abs()と同じ結果となります。

例

例: Math.hypot()を使う

Math.hypot(3, 4);        // 5
Math.hypot(3, 4, 5);     // 7.0710678118654755
Math.hypot();            // 0
Math.hypot(NaN);         // NaN
Math.hypot(3, 4, 'foo'); // NaN, +'foo' => NaN
Math.hypot(3, 4, '5');   // 7.0710678118654755, +'5' => 5
Math.hypot(-3);          // 3, the same as Math.abs(-3)

ポリフィル

次の関数を使用することでエミュレートできます。:

Math.hypot = Math.hypot || function() {
  var y = 0;
  var length = arguments.length;

  for (var i = 0; i < length; i++) {
    if (arguments[i] === Infinity || arguments[i] === -Infinity) {
      return Infinity;
    }
    y += arguments[i] * arguments[i];
  }
  return Math.sqrt(y);
};

仕様

ブラウザ実装状況

関連情報

• Math.abs()
• Math.pow()
• Math.sqrt()