Atomics.sub()
静态方法在数组中的给定位置减去给定值,并返回该位置的旧值。这个原子操作保证在修改后的值被写回之前不会发生其他写操作。
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.
语法
Atomics.sub(typedArray, index, value)
参数
-
typedArray
-
一个共享的整型 typed array。 例如
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
, 或者Uint32Array
. -
index
-
要被
value
值减去的typedArray
索引位置。 -
value
- 要减去的数字。
返回值
给定位置的旧值 (typedArray[index]
)。
异常
- 假如
typedArray
不是允许的整型之一,则抛出TypeError
。 - 假如
typedArray
不是一个共享的整型 typed array,则抛出TypeError
。 - 如果
index
超出了typedArray
的边界,则抛出RangeError
。
例子
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
规范
Specification | Status | Comment |
---|---|---|
ECMAScript Latest Draft (ECMA-262) Atomics.sub |
Draft | Initial definition in ES2017. |
浏览器支持
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out
https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sub |
Chrome Full support 68
|
Edge No support 16 — 17
|
Firefox Full support 57
|
IE No support No | Opera No support No | Safari No support 10.1 — ? | WebView Android No support 60 — 63
|
Chrome Android No support 60 — 63
|
Firefox Android Full support 57
|
Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No
|
nodejs Full support 8.10.0 |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.