CKTIS / JavaScript
Int32Array: vorzeichenbehaftete 32-Bit-Ganzzahlen
Int32Array speichert Zahlen als vorzeichenbehaftete 32-Bit-Ganzzahlen von -2147483648 bis 2147483647 mit 4 Byte je Element.
Version: 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?) erzeugt ein numerisches Typed Array aus Länge, Iterable/array-ähnlichem Wert, anderem numerischem Typed Array oder ArrayBuffer/SharedArrayBuffer. Die Pufferform teilt Bytes ohne Kopie, byteOffset muss durch 4 teilbar sein und BYTES_PER_ELEMENT ist 4.
Beim Schreiben wird ToNumber angewendet, der Bruch abgeschnitten, modulo 2^32 reduziert und das Ergebnis mit Vorzeichen interpretiert. Daher wird 2147483648 zu -2147483648, 4294967295 zu -1, und NaN sowie Unendlichkeiten werden 0. BigInt beim Schreiben oder ein BigInt Typed Array als Quelle löst TypeError aus. Byteordnung ist nativ; für explizites Endianness dient DataView.
Die Länge nutzt ToIndex: Brüche werden abgeschnitten, NaN/undefined werden 0 und -0.5 ergibt 0. Negatives Ergebnis nach ToIntegerOrInfinity, Unendlichkeit, falsch ausgerichteter Offset oder Bereich außerhalb des Puffers ergibt RangeError; abgelöster Puffer TypeError. Der Typ ist seit ECMAScript 2015 standardisiert.
Beispiele
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); }Ergebnis
2147483647,-2147483648,-1,2147483647,3,0,0 4 2 0 4 4 -123456 true