Atomics.compareExchange()
La méthode statique Atomics
.compareExchange()
échange une valeur d'un tableau à un emplacement donné si la valeur qui était dans le tableau correspond à une valeur donnée. Cette méthode renvoie l'ancienne valeur à cet emplacement, qu'il y ait eu remplacement ou non. 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.compareExchange(typedArray, index, valeurAttendue, valeurRemplacement)
Paramètres
typedArray
- Un tableau typé entier partagé parmi
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
ouUint32Array
. index
- La position du tableau
typedArray
à laquelle on veut échanger les valeurs. valeurAttendue
- La valeur avec laquelle on teste l'égalité.
valeurRemplacement
- Le nombre qu'on souhaite placer dans le tableau si l'ancienne valeur est égale avec
valeurAttendue
.
Valeur de retour
L'ancienne valeur présente à 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);
ta[0] = 7;
Atomics.compareExchange(ta, 0, 7, 12); // renvoie 7, l'ancienne valeur
Atomics.load(ta, 0); // 12
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript (ECMA-262) La définition de 'Atomics.compareExchange' dans cette spécification. |
Standard évolutif | Définition initiale avec ES2017. |
Compatibilité des navigateurs
BCD tables only load in the browser