Atomics.sub()

Atomics.sub() 静态方法在数组中的给定位置减去给定值,并返回该位置的旧值。这个原子操作保证在修改后的值被写回之前不会发生其他写操作。

语法

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 (ECMA-262)
Atomics.sub
Living Standard Initial definition in ES2017.

浏览器支持

BCD tables only load in the browser

相关