CKTIS / JavaScript
Uint32Array — масив от 32-битови цели числа без знак
Uint32Array е типизиран изглед към буфер: всеки елемент заема 4 байта и съхранява число от 0 до 4294967295. Научете за преобразуването на стойности, създаването на изгледи и разликата между споделянето на памет и копирането.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new Uint32Array(length)
new Uint32Array(iterableOrArrayLike)
new Uint32Array(typedArray)
new Uint32Array(buffer[, byteOffset[, length]])Uint32Array е типизиран масив: изглед към паметта, чиито елементи се четат като стойности Number от 0 до 4294967295. Всеки елемент заема 4 байта; length брои елементите, а byteLength — байтовете. Това не е обикновен Array и няма метод push().
new Uint32Array(length) създава буфер, запълнен с нули. При създаване от итерируем обект или друг типизиран масив с елементи от тип Number стойностите се копират. Ако източникът е BigInt64Array или BigUint64Array, конструкторът предизвиква TypeError дори когато изходният масив е празен. При създаване от ArrayBuffer масивът споделя паметта на буфера. byteOffset трябва да е кратно на 4; изрично зададеното length брои елементи, а не байтове.
При запис се прилага преобразуването ToUint32: стойността се отрязва към нулата, след което резултатът се взема по модул 2 ** 32. Така -1 става 4294967295, а 2 ** 32 + 7 става 7. NaN и безкрайностите стават 0; записването на BigInt предизвиква TypeError. Това е преобразуване, а не проверка на диапазона.
subarray() споделя паметта, докато slice() копира елементите. Редът на байтовете зависи от реализацията; използвайте DataView за двоични формати, които изискват изрично зададен ред на байтовете. В примера промяната на view[0] променя и values[1].
Примери
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);Резултат
1,42,7,3 4 16 4
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.