Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Uint32Array — tablica 32-bitowych liczb całkowitych bez znaku

Uint32Array to typowany widok bufora: każdy element zajmuje 4 bajty i przechowuje liczbę od 0 do 4294967295. Poznaj konwersję wartości, tworzenie widoków i różnicę między współdzieleniem pamięci a kopiowaniem.

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

Składnia

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

Uint32Array jest tablicą typowaną: widokiem pamięci, którego elementy są odczytywane jako wartości Number od 0 do 4294967295. Każdy zajmuje 4 bajty; length liczy elementy, a byteLength bajty. Nie jest zwykłą tablicą Array i nie ma metody push().

new Uint32Array(length) tworzy bufor wypełniony zerami. Konstrukcja z obiektu iterowalnego lub innej tablicy typowanej o elementach typu Number kopiuje wartości. Jeśli źródłem jest BigInt64Array lub BigUint64Array, konstruktor zgłasza TypeError, nawet gdy tablica źródłowa jest pusta. Konstrukcja z ArrayBuffer współdzieli jego pamięć. byteOffset musi być wielokrotnością 4; jawne length oznacza liczbę elementów, nie bajtów.

Zapis stosuje konwersję ToUint32: usuwa część ułamkową w kierunku zera, a następnie oblicza wynik modulo 2 ** 32. Dlatego -1 staje się 4294967295, a 2 ** 32 + 7 daje 7. NaN i nieskończoności stają się 0; zapis BigInt zgłasza TypeError. To konwersja, nie walidacja zakresu.

subarray() współdzieli pamięć, natomiast slice() kopiuje elementy. Kolejność bajtów jest natywna dla implementacji; do formatów binarnych wymagających jawnej kolejności używaj DataView. W przykładzie zmiana view[0] zmienia również values[1].

Przykłady

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);

Wynik

1,42,7,3
4 16 4

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła