Atomics.compareExchange
Atomics.compareExchange
Atomics.compareExchange()
静态方法会在数组的值与期望值相等的时候,将给定的替换值替换掉数组上的值,然后返回旧值。此原子操作保证在写上修改的值之前不会发生其他写操作。
语法
Atomics.compareExchange(typedArray, index, expectedValue, replacementValue)
参数
typedArray
一个共享的整型 typed array。例如 Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
,或Uint32Array
。indextypedArray
的索引。expectedValue
用于比较的值。replacementValue将要替换上的值。
返回值
给定位置的旧值(typedArray[index]
).
异常
- 假如
typedArray
不是允许的整型之一,则抛出TypeError
。
假如 typedArray
不是一个贡献的 typed array,则抛出TypeError
。
- 如果
index
超出了typedArray 的边界,则抛出
RangeError
。
示例
var sab = new SharedArrayBuffer(1024
var ta = new Uint8Array(sab
ta[0] = 7;
Atomics.compareExchange(ta, 0, 7, 12 // returns 7, the old value
Atomics.load(ta, 0 // 12
规范
Specification | Status | Comment |
---|---|---|
ECMAScript Latest Draft (ECMA-262)The definition of 'Atomics.compareExchange' in that specification. | Living Standard | Initial definition in ES2017. |
浏览器兼容性
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | No support 2 | No support | 55 (55) 1 | No support | No support | No support |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | No support | No support | 55.0 (55) 1 | No support | No support | No support |