Atomics.add()

静的な Atomics.add() メソッドは、配列内の指定した位置に値を追加して、その場所の古い値を返します。この atomic 操作は、修正された値が書き戻されるまで、他の書き込みが起こらないことを保証します。

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.add(typedArray, index, value)

パラメータ

typedArray

共有された整数の TypedArray。Int8Array か Uint8Array、Int16Array、Uint16Array、Int32Array、Uint32Array のいずれか。

index

value を追加する typedArray の位置

value

追加する数値。

戻り値

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

例外

• typedArray が許可された整数型ではなかった場合、TypeError をスローする。
• typedArray が共有された TypedArray 型ではなかった場合、TypeError をスローする。
• typedArray の index が境界から外れていた場合、RangeError をスローする。

例

const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);

Atomics.add(ta, 0, 12); // 古い値である 0 を返す。
Atomics.load(ta, 0); // 12

仕様

ブラウザ実装状況

関連項目

• Atomics
• Atomics.sub()