CKTIS / JavaScript
Int32Array: 32-битови цели числа със знак
Int32Array съхранява числата като 32-битови цели числа със знак от -2147483648 до 2147483647 с 4 байта на елемент.
Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2
Синтаксис
new Int32Array(); new Int32Array(length); new Int32Array(source); new Int32Array(buffer[, byteOffset[, length]])new Int32Array(source?, byteOffset?, length?) създава числов typed array от дължина, iterable/array-like, друг числов typed array или ArrayBuffer/SharedArrayBuffer. Буферната форма споделя байтове без копиране, byteOffset трябва да е кратно на 4, а BYTES_PER_ELEMENT е 4.
Записът прилага ToNumber, отрязва дробта, редуцира по модул 2^32 и тълкува резултата със знак. Така 2147483648 става -2147483648, 4294967295 става -1, а NaN и безкрайностите стават 0. Запис на BigInt или BigInt typed array като източник хвърля TypeError. Редът на байтовете е нативен; за явно endianness използвайте DataView.
Дължината използва ToIndex: дробите се отрязват, NaN/undefined стават 0 и -0.5 дава 0. Отрицателен резултат след ToIntegerOrInfinity, безкрайност, неподравнен offset или диапазон извън буфера хвърля RangeError; отделен буфер хвърля TypeError. Типът е стандартен от ECMAScript 2015.
Примери
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); }Резултат
2147483647,-2147483648,-1,2147483647,3,0,0 4 2 0 4 4 -123456 true