CKTIS / JavaScript
Int32Array: 32-bitové celé čísla so znamienkom
Int32Array ukladá čísla ako 32-bitové celé čísla so znamienkom od -2147483648 do 2147483647 so 4 bajtmi na prvok.
Verzia: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
new Int32Array(); new Int32Array(length); new Int32Array(source); new Int32Array(buffer[, byteOffset[, length]])new Int32Array(source?, byteOffset?, length?) vytvorí číselný typed array z dĺžky, iterable/array-like, iného číselného typed array alebo ArrayBuffer/SharedArrayBuffer. Bufferová forma zdieľa bajty bez kópie, byteOffset musí byť násobkom 4 a BYTES_PER_ELEMENT je 4.
Zápis použije ToNumber, odreže zlomok, redukuje modulo 2^32 a výsledok vyloží so znamienkom. Preto 2147483648 prejde na -2147483648, 4294967295 na -1 a NaN aj nekonečno na 0. Zápis BigInt alebo BigInt typed array ako zdroj vyvolá TypeError. Poradie bajtov je natívne; na explicitný endianness použite DataView.
Dĺžka používa ToIndex: zlomky sa odrežú, NaN/undefined sa zmenia na 0 a -0.5 dá 0. Záporný výsledok po ToIntegerOrInfinity, nekonečno, nezarovnaný offset alebo rozsah mimo buffer vyvolá RangeError; odpojený buffer vyvolá TypeError. Typ je štandardný od ECMAScript 2015.
Príklady
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); }Výsledok
2147483647,-2147483648,-1,2147483647,3,0,0 4 2 0 4 4 -123456 true