CKTIS / JavaScript
Int32Array: 32-bitowe liczby całkowite ze znakiem
Int32Array przechowuje liczby jako 32-bitowe całkowite ze znakiem od -2147483648 do 2147483647, po 4 bajty na element.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
new Int32Array(); new Int32Array(length); new Int32Array(source); new Int32Array(buffer[, byteOffset[, length]])new Int32Array(source?, byteOffset?, length?) tworzy numeric typed array z długości, iterable/array-like, innego numeric typed array albo ArrayBuffer/SharedArrayBuffer. Wariant buforowy współdzieli bajty bez kopiowania, byteOffset musi być wielokrotnością 4, a BYTES_PER_ELEMENT wynosi 4.
Zapis stosuje ToNumber, obcina ułamek i redukuje modulo 2^32, a następnie interpretuje wynik ze znakiem. Dlatego 2147483648 staje się -2147483648, 4294967295 staje się -1, a NaN i nieskończoności stają się 0. BigInt przy zapisie lub BigInt typed array jako źródło powoduje TypeError. Kolejność bajtów jest natywna; do jawnego endianness użyj DataView.
Długość używa ToIndex: ułamki są obcinane, NaN/undefined dają 0, a -0.5 daje 0. Ujemny wynik po ToIntegerOrInfinity, nieskończoność, niewyrównany offset lub zakres poza buforem powoduje RangeError; odłączony bufor powoduje TypeError. Typ jest standardowy od ECMAScript 2015.
Przykłady
const values = new Int32Array([2147483647, 2147483648, 4294967295, -2147483649, 3.9, NaN, Infinity]);
console.log(Array.from(values).join(","));
console.log(Int32Array.BYTES_PER_ELEMENT, new Int32Array(2.9).length, new Int32Array(-0.5).length);
const buffer = new ArrayBuffer(12);
const view = new Int32Array(buffer, 4, 1);
view[0] = -123456;
console.log(view.byteOffset, view.byteLength, view[0]);
try { view[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }Wynik
2147483647,-2147483648,-1,2147483647,3,0,0 4 2 0 4 4 -123456 true