Atomics.sub()

静的な Atomics.sub() メソッドは、配列内の所定の位置に指定された値を取り除いた上で、その位置にある古い値を返します。この atomic 操作は、修正された値が書き戻されるまで、ほかの書き込みが発生しないことを保証します。

構文

Atomics.sub(typedArray, index, value)

引数

typedArray

shared integer typed array。Int8Array か Uint8Array、Int16Array、Uint16Array、Int32Array、Uint32Array のいずれか。

index

取り除く value の typedArray 内での位置。

value

取り除く数値。

戻り値

指定した位置（typedArray[index]）の古い値。

例外

• typedArray が整数型を受け入れないない場合、TypeError をスローする。
• typedArray が shared typed array 型ではない場合、TypeError をスローする。
• index が typedArray の境界から外れている場合、RangeError をスローする。

例

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

仕様

ブラウザー実装状況

[1] この機能は設定で無効化されています。about:config で javascript.options.shared_memory を true に設定してください。

[2] 実装は開発中で次のランタイムフラグが必要です: --js-flags=--harmony-sharedarraybuffer --enable-blink-feature=SharedArrayBuffer

関連項目

• Atomics
• Atomics.add()