Atomics.sub()

Статический метод Atomics.sub() вычитает представленное значение из текущего по указанной позиции в массиве и возвращает предыдущее значение в этой позиции. Эта атомарная опреация гарантирует, что никакой другой записи не произойдет, пока измененное значение не будет записано обратно.

Синтаксис

Atomics.sub(typedArray, index, value)

Параметры

typedArray

Разделенный массив целых чисел. Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array или Uint32Array.

index

Позиция в typedArray для добавления value.

value

Число для вычитания.

Возвращаемое значение

Предыдущее значение в указанной позиции (typedArray[index]).

Исключения

• Выбрасывает TypeError,  если тип typedArray не является одним из допустимых тцелочисленных типов.
• Выбрасывает TypeError, если тип typedArray не общего типа.
• Выбрасывает RangeError, если index вне typedArray.

Примеры

var sab = new SharedArrayBuffer(1024);
var ta = new Uint8Array(sab);
ta[0] = 48;

Atomics.sub(ta, 0, 12); // возвращает 48, предыдущее значение
Atomics.load(ta, 0); // 36

Спецификации

Поддержка браузерами

[1] In Firefox version 46 until version 54, this feature is disabled by a preference setting. In about:config, set javascript.options.shared_memory to true. 

[2] The implementation is under development and needs these runtime flags: --js-flags=--harmony-sharedarraybuffer --enable-blink-feature=SharedArrayBuffer

Смотри также

• Atomics
• Atomics.add()