CKTIS / JavaScript
Uint32Array — pole 32bitových nezáporných celých čísel
Uint32Array je typovaný pohled na buffer: každý prvek zabírá 4 bajty a ukládá číslo od 0 do 4294967295. Seznamte se s převodem hodnot, vytvářením pohledů a rozdílem mezi sdílením paměti a kopírováním.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])Uint32Array je typované pole: paměťový pohled, jehož prvky se čtou jako hodnoty Number od 0 do 4294967295. Každý prvek zabírá 4 bajty; length počítá prvky, zatímco byteLength počítá bajty. Nejde o běžné Array a nemá metodu push().
new Uint32Array(length) vytvoří buffer vyplněný nulami. Při vytvoření z iterovatelného objektu nebo jiného typovaného pole s prvky typu Number se hodnoty zkopírují. Pokud je zdrojem BigInt64Array nebo BigUint64Array, konstruktor vyvolá TypeError, i když je zdrojové pole prázdné. Při vytvoření z ArrayBuffer se sdílí jeho paměť. byteOffset musí být násobkem 4; výslovně zadané length udává počet prvků, nikoli bajtů.
Při zápisu se použije převod ToUint32: hodnota se zkrátí směrem k nule a poté se výsledek vezme modulo 2 ** 32. Proto se -1 změní na 4294967295 a 2 ** 32 + 7 na 7. NaN a nekonečna se změní na 0; zápis hodnoty BigInt vyvolá TypeError. Jde o převod, nikoli o kontrolu rozsahu.
subarray() sdílí paměť, zatímco slice() prvky kopíruje. Pořadí bajtů závisí na implementaci; pro binární formáty vyžadující výslovné pořadí bajtů použijte DataView. V příkladu změna view[0] změní také values[1].
Příklady
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);Výsledek
1,42,7,3 4 16 4
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.