Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Int32Array: inteiros com sinal de 32 bits

Int32Array guarda números como inteiros com sinal de 32 bits entre -2147483648 e 2147483647, com 4 bytes por elemento.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

new Int32Array(); new Int32Array(length); new Int32Array(source); new Int32Array(buffer[, byteOffset[, length]])

new Int32Array(source?, byteOffset?, length?) cria um typed array numérico a partir de comprimento, iterable/array-like, outro typed array numérico ou ArrayBuffer/SharedArrayBuffer. A forma com buffer partilha bytes sem cópia, byteOffset tem de ser múltiplo de 4 e BYTES_PER_ELEMENT é 4.

A atribuição aplica ToNumber, trunca a fração, reduz módulo 2^32 e interpreta o resultado com sinal. Assim 2147483648 torna-se -2147483648, 4294967295 torna-se -1, e NaN e infinitos tornam-se 0. Atribuir BigInt ou usar typed array BigInt como origem lança TypeError. A ordem dos bytes é nativa; usa DataView para endianness explícito.

O comprimento usa ToIndex: frações são truncadas, NaN/undefined tornam-se 0 e -0.5 dá 0. Resultado negativo após ToIntegerOrInfinity, infinito, offset desalinhado ou intervalo fora do buffer lança RangeError; buffer separado lança TypeError. O tipo é padrão desde ECMAScript 2015.

Exemplos

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

Resultado

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

Fontes