Math.log2()

La fonction Math.log2() renvoie le logarithme en base 2 d'un nombre :

x>0,Math.log2(x)=log2(x)=l'unique ytel que2y=x\forall x > 0, \mathtt{\operatorname{Math.log2}(x)} = \log_2(x) = \text{the unique} \; y \; \text{such that} \; 2^y = x

Syntaxe

Math.log2(x)

Paramètres

x
Un nombre.

Valeur de retour

Le logarithme en base 2 du nombre passé en argument. Si ce nombre est négatif, c'est NaN qui sera renvoyé.

Description

Si x est strictement inférieur à 0, la valeur renvoyée sera NaN.

log2() étant une méthode statique de Math, il faut utiliser Math.log2() et non pas la méthode d'un autre objet qui aurait été créé (Math n'est pas un constructeur). Si on souhaite utiliser des constantes, on pourra employer Math.LOG2E ou Math.LN2.

Exemples

Utiliser Math.log2()

Math.log2(3);    // 1.584962500721156
Math.log2(2);    // 1
Math.log2(1);    // 0
Math.log2(0);    // -Infinity
Math.log2(-2);   // NaN
Math.log2(1024); // 10

Prothèse d'émulation (polyfill)

Si cette fonction n'est pas disponible, il est possible de l'écrire de la façon suivante (la constante implique une approximation) :

Math.log2 = Math.log2 || function(x) {
  return Math.log(x) * Math.LOG2E;
};

Note : Cette prothèse peut renvoyer des résultats imprécis avec certains arguments (par exemple 1 << 29). Si vous manipulez des masques binaires, vous pouvez utiliser Math.round() pour encadrer l'argument.

Spécifications

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

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple 38 25 (25) Pas de support 25 7.1
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple Pas de support Pas de support 25.0 (25) Pas de support Pas de support 8

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,