La méthode statiqueAtomics.sub() permet de soustraire une valeur donnée à une position donnée du tableau partagé. Elle renvoie l'ancienne valeur qui était contenue dans le tableau avant l'opération. Cette opération atomique garantit qu'aucune autre opération d'écriture n'est appliquée tant que la valeur modifiée n'est pas écrite.

Exemple interactif

// Create a SharedArrayBuffer with a size in bytesconst buffer = new SharedArrayBuffer(16);const uint8 = new Uint8Array(buffer);uint8[0] = 7;// 7 - 2 = 5console.log(Atomics.sub(uint8, 0, 2));// Expected output: 7console.log(Atomics.load(uint8, 0));// Expected output: 5

Syntaxe

Atomics.sub(typedArray, index, valeur);

Paramètres

typedArray

Un tableau typé entier partagé parmiInt8Array,Uint8Array,Int16Array,Uint16Array,Int32Array ouUint32Array.

index

La position du tableau typétypedArray à laquelle on veut soustrairevaleur.

valeur

La quantité qu'on souhaite soustraire.

Valeur de retour

L'ancienne valeur qui était contenue à (typedArray[index]).

Exceptions levées

• Cette méthode lèveTypeError si le type detypedArray n'est pas un des types entiers autorisés.
• Cette méthode lèveTypeError sitypedArray n'est pas tableau typé partagé.
• Cette méthode lèveRangeError siindex est en dehors des limites detypedArray.

Exemples

var sab = new SharedArrayBuffer(1024);var ta = new Uint8Array(sab);ta[0] = 48;Atomics.sub(ta, 0, 12); // renvoie 48, l'ancienne valeurAtomics.load(ta, 0); // 36

Spécifications

Compatibilité des navigateurs

Voir aussi

• Atomics
• Atomics.add()