Math.log1p()

La fonction Math.log1p() renvoie le logarithme népérien (en base e) d'un nombre +1, donné par la formule :

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

Syntaxe

Math.log1p(x)

Paramètres

x

Un nombre.

Valeur de retour

La valeur du logarithme naturel de 1 plus l'argument (log(1 + x)). Si l'argument est inférieur à -1, NaN est renvoyée.

Description

Si x est strictement inférieur à -1, la valeur renvoyée est NaN.

log1p étant une méthode statique de Math, il faut utiliser Math.log1p() et non pas la méthode d'un autre objet qui aurait été créé (Math n'est pas un constructeur).

Exemple

Utiliser Math.log1p()

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

Prothèse d'émulation (polyfill)

Si cette fonction n'est pas disponible, elle peut être définie grâce au code suivant :

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

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Math.log1p' dans cette spécification.
Standard Définition initiale.
ECMAScript (ECMA-262)
La définition de 'Math.log1p' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi