Math.log1p()

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

∀x>-1,Math.log1p(x)=ln(1+x)\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

Für sehr kleine Zahlen für x kann das Addieren mit 1 zu verlusten in der Präzision führen. Die Zahlen in JavaScript haben eine Genauigkeit von 15 Stellen. 1 + 1e-15 = 1.000000000000001, aber 1 + 1e-16 = 1.000000000000000 und damit exakt 1.0 in dieser Arithmetik, weil Ziffern nach der 15 Stelle gerundet werden.

Wenn log(1 + x) berechnet wird, bekommt man ein Ergebnis sehr na an x, wenn x klein ist (das ist der Grund, warum es 'natürlicher' Logarithmus heißt). Wenn Math.log(1 + 1.1111111111e-15) berechnet wird sollte man ein Ergebnis nah an 1.1111111111e-15 bekommt. Stattdessen berechnet man den Logarithmus von 1.00000000000000111022 (die Rundung geschieht im Binärsystem und ist manchmal unschön) un erhält das Ergebnis 1.11022...e-15 mit nur 3 korrekten Stellen. Wenn stattdessen Math.log1p(1.1111111111e-15) berechnet wird, bekommt man ein besseres Ergebnis von 1.1111111110999995e-15 mit 15 korrekten Stellen in der Präzision (aktuell 16 in diesem Fall).

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

Spezifikation Status Kommentar
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Math.log1p' in dieser Spezifikation.		 Standard Initiale Definition.
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Math.log1p' in dieser Spezifikation.		 Entwurf  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
log1pChrome Vollständige Unterstützung 38Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 25IE Keine Unterstützung NeinOpera Vollständige Unterstützung 25Safari Vollständige Unterstützung 8WebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung 38Firefox Android Vollständige Unterstützung 25Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung 8Samsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung 0.12

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Keine Unterstützung  
Keine Unterstützung

Siehe auch

Verwandte Themen
  1. Standard-Objekte
  2. Math
  3. Eigenschaften
    1. Math.E
    2. Math.LN10
    3. Math.LN2
    4. Math.LOG10E
    5. Math.LOG2E
    6. Math.PI
    7. Math.SQRT1_2
    8. Math.SQRT2
  4. Methoden
    1. Math.abs()
    2. Math.acos()
    3. Math.acosh()
    4. Math.asin()
    5. Math.asinh()
    6. Math.atan()
    7. Math.atan2()
    8. Math.atanh()
    9. Math.cbrt()
    10. Math.ceil()
    11. Math.clz32()
    12. Math.cos()
    13. Math.cosh()
    14. Math.exp()
    15. Math.expm1()
    16. Math.floor()
    17. Math.fround()
    18. Math.hypot()
    19. Math.imul()
    20. Math.log()
    21. Math.log10()
    22. Math.log1p()
    23. Math.log2()
    24. Math.max()
    25. Math.min()
    26. Math.pow()
    27. Math.random()
    28. Math.round()
    29. Math.sign()
    30. Math.sin()
    31. Math.sinh()
    32. Math.sqrt()
    33. Math.tan()
    34. Math.tanh()
    35. Math.trunc()
  5. Vererbung:
  6. Object
  7. Eigenschaften
    1. Object.prototype.__count__ [Übersetzen]
    2. Object.prototype.__noSuchMethod__ [Übersetzen]
    3. Object.prototype.__parent__ [Übersetzen]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  8. Methoden
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Übersetzen]
    3. Object.prototype.__lookupGetter__() [Übersetzen]
    4. Object.prototype.__lookupSetter__() [Übersetzen]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf() [Übersetzen]
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Übersetzen]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch() [Übersetzen]
    12. Object.prototype.valueOf()
    13. Object.prototype.watch() [Übersetzen]
    14. Object.setPrototypeOf() [Übersetzen]