La fonction Math.log2()
renvoie le logarithme en base 2 d'un nombre :
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.
et non pas la méthode d'un autre objet qui aurait été créé (log2
()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 |