Atomics.exchange()

Die statische Atomics.exchange() Methode ersetzt einen Wert an einer gegebenen Position im einem Array mit einem gegebene Wert aus. Die atomare Operation garantiert, dass kein anderer Schreibprozess während der Operation durchgeführt wird.

Syntax

Atomics.compareExchange(typedArray, index, value)

Parameter

typedArray
Ein geteiltes getrypted Integer Array. Eines von Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array oder Uint32Array.
index
Die Position in typedArray, an den ein Wert ersetzt wird.
value
Neu Zahl, die geschreiben wird.

Rückgabewert

Der alte Wert an der gegebenen Position (typedArray[index]).

Exceptions

  • Erzeugt einen TypeError, wenn typedArray nicht von einem erlaubten Integer Typ ist.
  • Erzeugt eine TypeError, wenn typedArray kein geteilter Arraytyp ist.
  • Erzeugt ein RangeError, wenn der index nicht in den Grenzen von typedArray ist.

Beispiele

var sab = new SharedArrayBuffer(1024);
var ta = new Uint8Array(sab);

Atomics.compareExchange(ta, 0, 12); // returns 0, the old value
Atomics.load(ta, 0); // 12

Spezifikationen

Spezifikation Status Kommentar
ECMAScript (ECMA-262)
Die Definition von 'Atomics.exchange' in dieser Spezifikation.
Lebender Standard Initiale Definition in ES2017.

Browserkompatibilität

BCD tables only load in the browser

Siehe auch