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.