База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Int16Array: 16-битови цели числа със знак

Int16Array съхранява числата като 16-битови цели числа със знак от -32768 до 32767 с 2 байта на елемент.

Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2

Синтаксис

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

new Int16Array(source?, byteOffset?, length?) създава числов typed array от дължина, iterable/array-like, друг числов typed array или ArrayBuffer/SharedArrayBuffer. Буферната форма не копира байтове, byteOffset трябва да е кратно на 2, а BYTES_PER_ELEMENT е 2.

Записът прилага ToNumber, отрязва дробта, редуцира по модул 2^16 и тълкува резултата със знак. Така 32768 става -32768, 65535 става -1, а NaN и безкрайностите стават 0. Запис на BigInt или BigInt typed array като източник хвърля TypeError. Редът на байтовете е нативен; за явно endianness използвайте DataView.

Дължината минава през ToIndex: дробите се отрязват, NaN/undefined стават 0 и -0.5 дава 0. Отрицателен резултат след ToIntegerOrInfinity, безкрайност, неподравнен offset или диапазон извън буфера хвърля RangeError; отделен буфер хвърля TypeError. Типът е стандартен от ECMAScript 2015.

Примери

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

Резултат

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

Източници