Atomics.sub()
Die statische Atomics
.sub()
Methode subtrahiert 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.
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.
Syntax
Atomics.add(typedArray, index, value)
Parameter
typedArray
- Ein geteiltes getrypted Integer Array. Eines von
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
oderUint32Array
. index
- Die Position in
typedArray
, zu dervalue
subtrahiert wird. value
- Die Zahl, die subtrahiert werden soll.
Return value
Der alte Wert an der gegebenen Position (typedArray[index]
).
Exceptions
- Erzeugt einen
TypeError
, wenntypedArray
nicht von einem erlaubten Integer Typ ist. - Erzeugt eine
TypeError
, wenntypedArray
kein geteilter Arraytyp ist. - Erzeugt ein
RangeError
, wenn derindex
nicht in den Grenzen vontypedArray
ist.
Beispiele
var sab = new SharedArrayBuffer(1024);
var ta = new Uint8Array(sab);
ta[0] = 48;
Atomics.sub(ta, 0, 12); // returns 48, the old value
Atomics.load(ta, 0); // 36
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
ECMAScript (ECMA-262) Die Definition von 'Atomics.sub' in dieser Spezifikation. |
Lebender Standard | Initiale Definition in ES2017. |
Browserkompatibilität
BCD tables only load in the browser