Atomics.add()

Die statische Atomics.add() Methode addiert eine gegebenen Wert an einer gegebenen Position im Array und gibt den alten Wert zurück. Diese atomare Operation garantiert, dass keine andere Schreiboperation während der Operation durchgeführt werden kann.

Syntax

Atomics.add(typedArray, index, value)

Parameter

typedArray
Ein geteiltes getrypted Integer Array. Eines von Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array oder Uint32Array.
index
Die Position in typedArray, zu der value addiert wird.
value
Die Zahl, die addiert werden soll.

Return value

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.add(ta, 0, 12); // returns 0, the old value
Atomics.load(ta, 0); // 12

Spezifikationen

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

Browserkompatibilität

BCD tables only load in the browser

Siehe auch