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). Attention à l'utilisation de nombres flottants avec Math.imul() car cela implique une opération de conversion des flottants vers les entiers pour la multiplication puis une opération de conversion du résultat en flottant. Dans la pratique, Math.imul() est notamment pertinent pour asm.js.

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);
};

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 Latest Draft (ECMA-262)
La définition de 'Math.imul' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung InternetNode.js
Support simpleChrome Support complet 28Edge Support complet OuiFirefox Support complet 20IE Aucun support NonOpera Support complet 16Safari Support complet 7WebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 20Opera Android Support complet OuiSafari iOS Support complet 7Samsung Internet Android Support complet Ouinodejs Support complet 0.12

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Étiquettes et contributeurs liés au document

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