CKTIS / JavaScript
Uint32Array — array di interi senza segno a 32 bit
Uint32Array è una vista tipizzata su un buffer: ogni elemento occupa 4 byte e memorizza un numero da 0 a 4294967295. Scopri la conversione dei valori, la creazione delle viste e la differenza tra memoria condivisa e copia.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
new Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])Uint32Array è un array tipizzato: una vista della memoria i cui elementi vengono letti come valori Number da 0 a 4294967295. Ogni elemento occupa 4 byte; length conta gli elementi, mentre byteLength conta i byte. Non è un normale Array e non dispone del metodo push().
new Uint32Array(length) crea un buffer riempito di zeri. La costruzione a partire da un oggetto iterabile o da un altro array tipizzato con elementi di tipo Number copia i valori. Se l’origine è un BigInt64Array o un BigUint64Array, il costruttore genera un TypeError, anche se l’array di origine è vuoto. La costruzione da un ArrayBuffer ne condivide la memoria. byteOffset deve essere un multiplo di 4; un length esplicito indica il numero di elementi, non di byte.
La scrittura applica la conversione ToUint32: tronca il valore verso zero e poi calcola il risultato modulo 2 ** 32. Quindi -1 diventa 4294967295 e 2 ** 32 + 7 diventa 7. NaN e gli infiniti diventano 0; scrivere un BigInt genera un TypeError. Si tratta di una conversione, non di un controllo dell’intervallo.
subarray() condivide la memoria, mentre slice() copia gli elementi. L’ordine dei byte dipende dall’implementazione; usa DataView per i formati binari che richiedono un ordine dei byte esplicito. Nell’esempio, modificare view[0] modifica anche values[1].
Esempi
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);Risultato
1,42,7,3 4 16 4
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.