Die statische MethodeAtomics.sub() subtrahiert einen angegebenen Wert an einer angegebenen Position im Array und gibt den alten Wert an dieser Position zurück. Diese atomare Operation garantiert, dass keine andere Schreiboperation stattfindet, bis der modifizierte Wert zurückgeschrieben wird.

Syntax

Atomics.sub(typedArray, index, value)

Parameter

typedArray

Ein Integer-Typed-Array. Eines vonInt8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,BigInt64Array oderBigUint64Array.

index

Die Position imtypedArray, von der einvalue 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, wenntypedArray nicht einer der erlaubten Integer-Typen ist.

RangeError

Wird ausgelöst, wenn derindex außerhalb der Grenzen imtypedArray liegt.

Beispiele

Beachten Sie, dass diese Beispiele nicht direkt aus der Konsole oder von einer beliebigen Webseite ausgeführt werden können, daSharedArrayBuffer nicht definiert ist, es sei denn, seineSicherheitsanforderungen sind erfüllt.

Verwendung von Atomics.sub()

// Create a SharedArrayBuffer with a size in bytesconst sab = new SharedArrayBuffer(1024);// Create a view and set the value of the 0 indexconst ta = new Uint8Array(sab);ta[0] = 48;// 48 - 12 = 36console.log(Atomics.sub(ta, 0, 12)); // 48, the old valueconsole.log(Atomics.load(ta, 0)); // 36, the new/current value

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Atomics
• Atomics.add()