Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Uint32Array — matriz de inteiros sem sinal de 32 bits

Uint32Array é uma vista tipada sobre um buffer: cada elemento ocupa 4 bytes e armazena um número entre 0 e 4294967295. Descubra como funciona a conversão de valores, a criação de vistas e a diferença entre partilhar memória e copiar.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])

Uint32Array é uma matriz tipada: uma vista da memória cujos elementos são lidos como valores Number entre 0 e 4294967295. Cada elemento ocupa 4 bytes; length conta elementos, enquanto byteLength conta bytes. Não é uma matriz Array normal e não tem o método push().

new Uint32Array(length) cria um buffer preenchido com zeros. A construção a partir de um objeto iterável ou de outra matriz tipada com elementos do tipo Number copia os valores. Se a origem for um BigInt64Array ou um BigUint64Array, o construtor lança um TypeError, mesmo que a matriz de origem esteja vazia. A construção a partir de um ArrayBuffer partilha a respetiva memória. byteOffset tem de ser múltiplo de 4; um length explícito conta elementos, não bytes.

Ao escrever, é aplicada a conversão ToUint32: o valor é truncado em direção a zero e, em seguida, calcula-se o resultado módulo 2 ** 32. Assim, -1 passa a 4294967295 e 2 ** 32 + 7 passa a 7. NaN e os infinitos passam a 0; escrever um BigInt gera um TypeError. Trata-se de uma conversão, não de uma validação do intervalo.

subarray() partilha a memória, enquanto slice() copia os elementos. A ordem dos bytes depende da implementação; utilize DataView para formatos binários que exijam uma ordem explícita dos bytes. No exemplo, alterar view[0] também altera values[1].

Exemplos

const values = new Uint32Array([1, -1, 2 ** 32 + 7, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(values.length, values.byteLength, Uint32Array.BYTES_PER_ELEMENT);

Resultado

1,42,7,3
4 16 4

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes