Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Int16Array: 16-bitowe liczby całkowite ze znakiem

Int16Array przechowuje liczby jako 16-bitowe całkowite ze znakiem od -32768 do 32767, po 2 bajty na element.

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

Składnia

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

new Int16Array(source?, byteOffset?, length?) tworzy numeric typed array z długości, iterable/array-like, innego numeric typed array albo ArrayBuffer/SharedArrayBuffer. Wariant buforowy nie kopiuje bajtów, byteOffset musi być wielokrotnością 2, a BYTES_PER_ELEMENT wynosi 2.

Zapis stosuje ToNumber, obcina część ułamkową i redukuje modulo 2^16, po czym interpretuje wynik ze znakiem. Dlatego 32768 staje się -32768, 65535 staje się -1, a NaN i nieskończoności stają się 0. BigInt przy zapisie lub BigInt typed array jako źródło powoduje TypeError. Kolejność bajtów jest natywna; do jawnego endianness użyj DataView.

Długość przechodzi ToIndex: ułamki są obcinane, NaN/undefined dają 0, a -0.5 daje 0. Ujemny wynik po ToIntegerOrInfinity, nieskończoność, niewyrównany offset lub zakres poza buforem powoduje RangeError; odłączony bufor powoduje TypeError. Typ jest standardowy od ECMAScript 2015.

Przykłady

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

Wynik

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

Źródła