Math.imul()

La fonction Math.imul() renvoie le résultat de la multiplication de deux nombres, calculée avec la représentation sur 32 bits de ces nombres, à la façon du langage C.

Syntaxe

Math.imul(a, b)

Paramètres

a
Le premier nombre.
b
Le second nombre.

Valeur de retour

Le résultat de la multiplication sur 32 bits des valeurs passées en argument (comme en C).

Description

Math.imul() permet d'effectuer une multiplication rapide pour des entiers sur 32 bits avec une sémantique proche du langage C. Cela est utile pour des aspects de performance, notamment pour des projets comme Emscripten. imul() étant une méthode statique de Math, il faut utiliser Math.imul() et non pas la méthode d'un autre objet qui aurait été créé (Math n'est pas un constructeur).

Exemples

Utiliser Math.imul()

Math.imul(2, 4);          // 8
Math.imul(-1, 8);         //-8
Math.imul(-2, -2);        // 4
Math.imul(0xffffffff, 5); //-5
Math.imul(0xfffffffe, 5); //-10

Prothèse d'émulation (polyfill)

Si elle n'est pas disponible, cette fonction peut être émulée de la façon suivante :

Math.imul = Math.imul || function(a, b) {
  var ah  = (a >>> 16) & 0xffff;
  var al = a & 0xffff;
  var bh  = (b >>> 16) & 0xffff;
  var bl = b & 0xffff;
  // Le décalage par 0 rétablit le signe de la partie haute
  // le |0 final convertit la valeur non-signée en une valeur signée
  return ((al * bl) + (((ah * bl + al * bh) << 16) >>> 0)|0);
};

On pourra également utiliser cette méthode pour les navigateurs qui reposent sur un système n'utilisant pas d'optimisation sur les opérations entières.

Math.imul = Math.imul || (function()
  if (document.documentMode&&(document.documentMode!=0)&&(doument.documentMode<5)) {
    // For Internet Explorer version less than 5, where the Math library support is iffy
    return function(a, b) {
      // 2147483648 = 231 = the maximum value of a signed integer plus one
      var product = a*b, remainder = product%2147483648;
      return (product-remainder)/2147483648 + remainder;
    };
  } else {
    // If the browser supports most of the Math library. Also, if the browser compiles the javascript then theres a good chance it will recognize the
    //  division and modulus of the same variable, and optimize the division and modulus into a single instruction.
    return function(a, b) {
      var product = a * b;
      return Math.floor(product/2147483648)+(product%2147483648);
    };
  }
})();

Spécifications

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

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple 28 20 (20) ? 16 7
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple ? ? 20.0 (20) ? ? 7

Étiquettes et contributeurs liés au document

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