Atomics.store()

Статический метод Atomics.store() сохраняет заданное значение в заданной позиции массива и возвращает это значение. Эта атомарная операция гарантирует, что запись является неделимой (tear-free), и что все атомарные записи последовательно согласованы.

Обратите внимание, что, в отличие от многих других методов Atomic, store() возвращает новое значение вместо старого. Чтобы получить старое значение, используйте Atomics.exchange().

Синтаксис

Atomics.store(typedArray, index, value)

Параметры

typedArray

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

index

Позиция в typedArray для сохранения value.

value

Число для сохранения.

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

Сохраненное значение.

Исключения

TypeError

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

RangeError

Выбрасывается, если index находится вне границ в typedArray.

Примеры

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

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

// Create a SharedArrayBuffer with a size in bytes
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);

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

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

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

См. также

• Atomics
• Atomics.load()
• Atomics.exchange()