Math.log1p()

概要

引数として与えた数と 1 の合計の自然対数(底 e)を返します。すなわち

$$\forall x > -1, \mathtt{\operatorname{Math.log1p}(x)} = \ln(1 + x)$$

構文

Math.log1p(x)

引数

x

数値

説明

xの値が-1未満なら、戻り値は常にNaNです。

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

例

例: Math.log1p()を使う

Math.log1p(1);  // 0.6931471805599453
Math.log1p(0);  // 0
Math.log1p(-1); // -Infinity
Math.log1p(-2); // NaN

ポリフィル

次の関数でエミュレートできます。:

Math.log1p = Math.log1p || function(x) {
  return Math.log(1 + x);
};

仕様

ブラウザ実装状況

関連情報

• Math.exp()
• Math.log()
• Math.log10()
• Math.log2()
• Math.pow()