Atomics.exchange()

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

Синтаксис

Atomics.exchange(typedArray, index, value)

Параметры

typedArray

Массив типизированных целых чисел. Один из Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array, или BigUint64Array.

index

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

value

Число для обмена.

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

Старое значение на заданной позиции (typedArray[index]).

Исключения

TypeError

Выбрасывается, если typedArray не является одним из разрешенных целочисленных типов.

RangeError

Выбрасывается, если index выходит за пределы typedArray.

Примеры

Обратите внимание, что эти примеры нельзя запустить непосредственно из консоли или с произвольной веб-страницы, поскольку SharedArrayBuffer не определен, если не соблюдены его требования безопасности.

Использование Atomics.exchange()

// Create a SharedArrayBuffer with a size in bytes
const sab = new SharedArrayBuffer(1024);
// Create a view and set the value of the 0 index
const ta = new Uint8Array(sab);
ta[0] = 7;

console.log(Atomics.exchange(ta, 0, 12)); // 7, the old value
console.log(Atomics.load(ta, 0)); // 12, the new/current value

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

Совместимость с браузерами

Смотрите также

• Atomics
• Atomics.compareExchange()
• Atomics.store()