Math.log1p()

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

$\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

Compatibilité des navigateurs

Voir aussi

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