Math.log1p

Math.log1p() 函数返回一个数字加1后的自然对数 (底为 E), 既log(x+1).

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

语法

Math.log1p(x)

参数

x一个数值。

返回值

自然对数（底数e的）1加上所述给定数量。如果数字小于-1，则返回NaN。

描述

对于非常小的x值，加1可以降低或消除精度。JS中使用的双浮点数可以提供大约15位的精度。1 + 1e-15 = 1.000000000000001，但1 + 1e-16 = 1.000000000000000，因此该算术中恰好为1.0，因为过去15位的数字被四舍五入。

当你计算log（1 + x）时，如果x很小（这就是为什么这些被称为“自然”对数），你应该得到一个非常接近x的答案。如果你计算Math.log（1 + 1.1111111111e-15）你应该得到一个答案接近1.1111111111e-15。相反，你最终将采取1.00000000000000111022的对数（舍入是二进制的，所以有时会变得难看），所以你得到答案1.11022 ... e-15，也就是只有3个正确的数字。相反，如果你计算Math.log1p（1.1111111111e-15），你将得到一个更准确的答案1.1111111110999995e-15，精度为15个正确的数字（在这种情况下实际上是16）。

如果参数的值小于-1, 则返回 NaN.

因为log1p()是Math的一个静态方法，用作Math.log1p()，而不是你创建的Math对象的方法（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);
};

规范

浏览器兼容性