Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Uint32Array — pole 32-bitových nezáporných celých čísel

Uint32Array je typovaný pohľad na buffer: každý prvok zaberá 4 bajty a ukladá číslo od 0 do 4294967295. Zoznámte sa s prevodom hodnôt, vytváraním pohľadov a rozdielom medzi zdieľaním pamäte a kopírovaním.

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

Syntax

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

Uint32Array je typované pole: pamäťový pohľad, ktorého prvky sa čítajú ako hodnoty Number od 0 do 4294967295. Každý prvok zaberá 4 bajty; length počíta prvky, zatiaľ čo byteLength počíta bajty. Nie je to bežné Array a nemá metódu push().

new Uint32Array(length) vytvorí buffer vyplnený nulami. Pri vytvorení z iterovateľného objektu alebo iného typovaného poľa s prvkami typu Number sa hodnoty skopírujú. Ak je zdrojom BigInt64Array alebo BigUint64Array, konštruktor vyvolá TypeError, aj keď je zdrojové pole prázdne. Pri vytvorení z ArrayBuffer sa zdieľa jeho pamäť. byteOffset musí byť násobkom 4; výslovne zadané length udáva počet prvkov, nie bajtov.

Pri zápise sa použije prevod ToUint32: hodnota sa skráti smerom k nule a potom sa výsledok vezme modulo 2 ** 32. Preto sa -1 zmení na 4294967295 a 2 ** 32 + 7 na 7. NaN a nekonečná hodnota sa zmenia na 0; zápis hodnoty BigInt vyvolá TypeError. Ide o prevod, nie o kontrolu rozsahu.

subarray() zdieľa pamäť, zatiaľ čo slice() prvky kopíruje. Poradie bajtov závisí od implementácie; pre binárne formáty vyžadujúce výslovné poradie bajtov použite DataView. V príklade zmena view[0] zmení aj values[1].

Prí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ýsledok

1,42,7,3
4 16 4

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje