Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Int16Array: 16-bitové celé čísla so znamienkom

Int16Array ukladá čísla ako 16-bitové celé čísla so znamienkom od -32768 do 32767 s 2 bajtmi na prvok.

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

Syntax

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

new Int16Array(source?, byteOffset?, length?) vytvorí číselný typed array z dĺžky, iterable/array-like, iného číselného typed array alebo ArrayBuffer/SharedArrayBuffer. Bufferová forma bajty nekopíruje, byteOffset musí byť násobkom 2 a BYTES_PER_ELEMENT je 2.

Zápis použije ToNumber, odreže zlomok, redukuje modulo 2^16 a výsledok vyloží so znamienkom. Preto sa 32768 zmení na -32768, 65535 na -1 a NaN aj nekonečno na 0. Zápis BigInt alebo BigInt typed array ako zdroj vyvolá TypeError. Poradie bajtov je natívne; na explicitný endianness použite DataView.

Dĺžka prechádza ToIndex: zlomky sa odrežú, NaN/undefined sa zmenia na 0 a -0.5 dá 0. Záporný výsledok po ToIntegerOrInfinity, nekonečno, nezarovnaný offset alebo rozsah mimo buffer vyvolá RangeError; odpojený buffer vyvolá TypeError. Typ je štandardný od ECMAScript 2015.

Príklady

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

Výsledok

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

Zdroje