Atomics.add()
O método estátitico Atomics.add()
adiciona um dado valor em uma determinada posição no array e retorna o valor antigo daquela posição. Esta operação atômica garante que nenhuma outra escrita ocorra até que o valor modificado seja escrito de volta.
Sintaxe
Atomics.add(typedArray, index, value)
Parâmetros
typedArray
-
Um array tipado de inteiros compartilhado. Pode ser
Int8Array
(en-US),Uint8Array
(en-US),Int16Array
,Uint16Array
(en-US),Int32Array
(en-US), ouUint32Array
(en-US). index
-
A posição no
typedArray
onde ovalue
será adicionado. value
-
Número que será adicionado.
Valor de retorno
O valor antigo na determinada posição (typedArray[index]
).
Exceções
- Lança uma exceção
TypeError
, se otypedArray
não for um dos tipos de inteiro permitidos. - Lança uma exceção
TypeError
, se otypedArray
não for tipo array tipado compartilhado. - Lança uma exceção
RangeError
(en-US), se oindex
estiver fora dos limites notypedArray
.
Exemplos
var sab = new SharedArrayBuffer(1024);
var ta = new Uint8Array(sab);
Atomics.add(ta, 0, 12); // retorna 0, o valor antigo
Atomics.load(ta, 0); // 12
Especificações
Especificação | Status | Comentário |
---|---|---|
ECMAScript (ECMA-262) The definition of 'Atomics.add' in that specification. |
Padrão em tempo real | Definição inicial no ES2017. |
Compatibilidade com navegadores
BCD tables only load in the browser