CKTIS / JavaScript
Uint32Array — polje neoznačenih 32-bitnih cijelih brojeva
Uint32Array tipizirani je pogled na međuspremnik: svaki element zauzima 4 bajta i pohranjuje broj od 0 do 4294967295. Saznajte kako se vrijednosti pretvaraju, kako se izrađuju pogledi te koja je razlika između dijeljenja memorije i kopiranja.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])Uint32Array je tipizirano polje: memorijski pogled čiji se elementi čitaju kao vrijednosti Number od 0 do 4294967295. Svaki element zauzima 4 bajta; length broji elemente, a byteLength bajtove. To nije običan Array i nema metodu push().
new Uint32Array(length) stvara međuspremnik ispunjen nulama. Pri izradi iz iterabilnog objekta ili drugog tipiziranog polja s elementima tipa Number vrijednosti se kopiraju. Ako je izvor BigInt64Array ili BigUint64Array, konstruktor izaziva TypeError čak i ako je izvorno polje prazno. Pri izradi iz ArrayBuffer polje dijeli memoriju s tim međuspremnikom. byteOffset mora biti višekratnik broja 4; izričito zadani length broji elemente, a ne bajtove.
Pri zapisivanju se primjenjuje pretvorba ToUint32: vrijednost se odbacivanjem decimalnog dijela pomiče prema nuli, a zatim se rezultat uzima modulo 2 ** 32. Zato -1 postaje 4294967295, a 2 ** 32 + 7 postaje 7. NaN i beskonačnosti postaju 0; zapisivanje vrijednosti BigInt izaziva TypeError. To je pretvorba, a ne provjera raspona.
subarray() dijeli memoriju, dok slice() kopira elemente. Redoslijed bajtova ovisi o implementaciji; za binarne formate koji zahtijevaju izričit redoslijed bajtova upotrijebite DataView. U primjeru promjena view[0] mijenja i values[1].
Primjeri
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);Rezultat
1,42,7,3 4 16 4
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.