CKTIS / JavaScript
Int32Array : entiers signés sur 32 bits
Int32Array stocke les nombres comme entiers signés sur 32 bits de -2147483648 à 2147483647, avec 4 octets par élément.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
new Int32Array(); new Int32Array(length); new Int32Array(source); new Int32Array(buffer[, byteOffset[, length]])new Int32Array(source?, byteOffset?, length?) crée un typed array numérique depuis une longueur, un itérable/array-like, un autre typed array numérique ou un ArrayBuffer/SharedArrayBuffer. La forme tampon partage les octets sans copie, byteOffset doit être multiple de 4 et BYTES_PER_ELEMENT vaut 4.
L’affectation applique ToNumber, tronque la fraction, réduit modulo 2^32, puis interprète avec signe. Ainsi 2147483648 devient -2147483648, 4294967295 devient -1, et NaN comme les infinis deviennent 0. Affecter un BigInt ou fournir un typed array BigInt lève TypeError. L’ordre des octets est natif ; utilisez DataView pour un endianness explicite.
La longueur utilise ToIndex : les fractions sont tronquées, NaN/undefined deviennent 0 et -0.5 donne 0. Résultat négatif après ToIntegerOrInfinity, infinité, offset mal aligné ou plage hors tampon lève RangeError ; tampon détaché lève TypeError. Le type est standard depuis ECMAScript 2015.
Exemples
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); }Résultat
2147483647,-2147483648,-1,2147483647,3,0,0 4 2 0 4 4 -123456 true