La méthode statique Atomics
.add()
ajoute une valeur donnée à un élément du tableau à une position donnée. Elle renvoie l'ancienne valeur qui était contenue à cet emplacement. 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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
Atomics.add(typedArray, index, valeur)
Paramètres
typedArray
- Un tableau typé entier partagé parmi
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
ouUint32Array
. index
- La position du tableau
typedArray
auquel on souhaite ajouter unevaleur
. valeur
- La valeur à ajouter.
Valeur de retour
L'ancienne valeur qui était contenue à (typedArray[index]
).
Exceptions levées
- Cette méthode lève
TypeError
si le type detypedArray
n'est pas un des types entiers autorisés. - Cette méthode lève
TypeError
sitypedArray
n'est pas tableau typé partagé. - Cette méthode lève
RangeError
siindex
est en dehors des limites detypedArray
.
Exemples
var sab = new SharedArrayBuffer(1024);
var ta = new Uint8Array(sab);
Atomics.add(ta, 0, 12); // renvoie 0, l'ancienne valeur
Atomics.load(ta, 0); // 12
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript (ECMA-262) La définition de 'Atomics.add' dans cette spécification. |
Standard évolutif | Définition initiale avec ES2017. |
Compatibilité des navigateurs
BCD tables only load in the browser