KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Int32Array: 32-bits gehele getallen met teken

Int32Array bewaart getallen als 32-bits gehele getallen met teken van -2147483648 tot en met 2147483647, met 4 bytes per element.

Versie: 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?) maakt een numerieke typed array uit lengte, iterable/array-achtig, andere numerieke typed array of ArrayBuffer/SharedArrayBuffer. De buffervorm deelt bytes zonder kopie, byteOffset moet een veelvoud van 4 zijn en BYTES_PER_ELEMENT is 4.

Toewijzing past ToNumber toe, kapt de breuk af, reduceert modulo 2^32 en interpreteert het resultaat met teken. Daardoor wordt 2147483648 -2147483648, 4294967295 wordt -1, en NaN en oneindigheden worden 0. BigInt toewijzen of een BigInt typed array als bron werpt TypeError. Bytevolgorde is systeemeigen; gebruik DataView voor expliciet endianness.

De lengte gebruikt ToIndex: breuken worden afgekapt, NaN/undefined worden 0 en -0.5 geeft 0. Negatief resultaat na ToIntegerOrInfinity, oneindigheid, verkeerd uitgelijnde offset of bereik buiten de buffer werpt RangeError; losgekoppelde buffer werpt TypeError. Het type is standaard sinds ECMAScript 2015.

Voorbeelden

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); }

Resultaat

2147483647,-2147483648,-1,2147483647,3,0,0
4 2 0
4 4 -123456
true

Bronnen