From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../reference/global_objects/math/imul/index.md | 95 +++++++++------------- 1 file changed, 40 insertions(+), 55 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/math/imul') diff --git a/files/fr/web/javascript/reference/global_objects/math/imul/index.md b/files/fr/web/javascript/reference/global_objects/math/imul/index.md index bdfb591384..507c94f070 100644 --- a/files/fr/web/javascript/reference/global_objects/math/imul/index.md +++ b/files/fr/web/javascript/reference/global_objects/math/imul/index.md @@ -10,81 +10,66 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Math/imul original_slug: Web/JavaScript/Reference/Objets_globaux/Math/imul --- -
{{JSRef}}
+{{JSRef}} -

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.

+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. -
{{EmbedInteractiveExample("pages/js/math-imul.html")}}
+{{EmbedInteractiveExample("pages/js/math-imul.html")}} -

Syntaxe

+## Syntaxe -
Math.imul(a, b)
+ Math.imul(a, b) -

Paramètres

+### Paramètres -
-
a
-
Le premier nombre.
-
b
-
Le second nombre.
-
+- `a` + - : Le premier nombre. +- `b` + - : Le second nombre. -

Valeur de retour

+### Valeur de retour -

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

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

Description

+## 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.

+`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](/fr/docs/Mozilla/Projects/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

+## Exemples -

Utiliser Math.imul()

+### Utiliser `Math.imul()` -
Math.imul(2, 4);          // 8
+```js
+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)

+## Prothèse d'émulation (_polyfill_) -

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

+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;
+```js
+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);
+  return ((al * bl) + (((ah * bl + al * bh) << 16) >>> 0)|0);
 };
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES6', '#sec-math.imul', 'Math.imul')}}{{Spec2('ES6')}}Définition initiale
{{SpecName('ESDraft', '#sec-math.imul', 'Math.imul')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Math.imul")}}

+``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------ | ---------------------------- | ------------------- | +| {{SpecName('ES6', '#sec-math.imul', 'Math.imul')}} | {{Spec2('ES6')}} | Définition initiale | +| {{SpecName('ESDraft', '#sec-math.imul', 'Math.imul')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Math.imul")}} -- cgit v1.2.3-54-g00ecf