Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Int16Array: interi con segno a 16 bit

Int16Array memorizza numeri come interi con segno a 16 bit da -32768 a 32767, con 2 byte per elemento.

Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintassi

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

new Int16Array(source?, byteOffset?, length?) crea un typed array numerico da lunghezza, iterable/array-like, altro typed array numerico o ArrayBuffer/SharedArrayBuffer. La forma con buffer non copia i byte, byteOffset deve essere multiplo di 2 e BYTES_PER_ELEMENT vale 2.

L’assegnazione applica ToNumber, tronca la frazione, riduce modulo 2^16 e interpreta il risultato con segno. Quindi 32768 diventa -32768, 65535 diventa -1, e NaN e infiniti diventano 0. Assegnare BigInt o usare un typed array BigInt come sorgente genera TypeError. L’ordine dei byte è nativo; usa DataView per endianness esplicito.

La lunghezza passa per ToIndex: le frazioni sono troncate, NaN/undefined diventano 0 e -0.5 dà 0. Risultato negativo dopo ToIntegerOrInfinity, infinito, offset disallineato o intervallo fuori buffer genera RangeError; buffer scollegato genera TypeError. Il tipo è standard da ECMAScript 2015.

Esempi

const values = new Int16Array([32767, 32768, 65535, -32769, 3.9, NaN, Infinity]);
console.log(Array.from(values).join(","));
console.log(Int16Array.BYTES_PER_ELEMENT, new Int16Array(2.9).length, new Int16Array(-0.5).length);

const buffer = new ArrayBuffer(6);
const view = new Int16Array(buffer, 2, 1);
view[0] = -1234;
console.log(view.byteOffset, view.byteLength, view[0]);
try { view[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }

Risultato

32767,-32768,-1,32767,3,0,0
2 2 0
2 2 -1234
true

Fonti