Atomics.sub()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2021.

Die statische Methode Atomics.sub() subtrahiert einen gegebenen Wert an einer angegebenen Position im Array und gibt den alten Wert an dieser Position zurück. Diese atomare Operation garantiert, dass kein anderer Schreibvorgang erfolgt, bis der modifizierte Wert zurückgeschrieben wird.

Probieren Sie es aus

Syntax

Atomics.sub(typedArray, index, value)

Parameter

typedArray: Ein Ganzzahl-typisiertes Array. Eines von Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array oder BigUint64Array.
index: Die Position im typedArray, von der ein value subtrahiert werden soll.
value: Die Zahl, die subtrahiert werden soll.

Rückgabewert

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

Ausnahmen

TypeError: Wird ausgelöst, wenn typedArray nicht einer der erlaubten Ganzzahltypen ist.
RangeError: Wird ausgelöst, wenn index außerhalb der Grenzen des typedArray liegt.

Beispiele

Verwendung von sub

const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);
ta[0] = 48;

Atomics.sub(ta, 0, 12); // returns 48, the old value
Atomics.load(ta, 0); // 36

Spezifikationen

Specification
ECMAScript Language Specification # sec-atomics.sub

Browser-Kompatibilität

BCD tables only load in the browser