Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje