Math.log1p()

Die Math.log1p() Funktion gibt den natürlichen Logarithmus (Logarithmus zur Basis e) von 1 + x zurück. Das bedeutet

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

Syntax

Math.log1p(x)

Parameter

x

Eine Zahl.

Rückgabewert

Den natürliche Logarithmus (zur Basis e) von 1 plus der gegebenen Zahl. Wenn die Zahl kleiner als -1 ist, wird NaN zurückgegeben.

Beschreibung

Wenn der Wert von x kleiner als -1 ist, gibt die Funktion immer den Wert NaN zurück.

Weil log1p() eine statische Funktion von Math ist, wird es immer als Math.log1p() eingesetzt, jedoch nicht als Methode eines erzeugten Math Objektes (Math ist kein Konstruktor).

Beispiele

Einsatz von Math.log1p()

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

Polyfill

Diese funktion kann folgendermaßen emuliert werden:

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

Spezifikationen

Browserkompatibilität

Siehe auch

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