WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Int16Array: vorzeichenbehaftete 16-Bit-Ganzzahlen

Int16Array speichert Zahlen als vorzeichenbehaftete 16-Bit-Ganzzahlen von -32768 bis 32767 mit 2 Byte je Element.

Version: 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?) erzeugt ein numerisches Typed Array aus Länge, Iterable/array-ähnlichem Wert, anderem numerischem Typed Array oder ArrayBuffer/SharedArrayBuffer. Die Pufferform kopiert keine Bytes, byteOffset muss durch 2 teilbar sein und BYTES_PER_ELEMENT ist 2.

Beim Schreiben wird ToNumber angewendet, der Bruch abgeschnitten, modulo 2^16 reduziert und das Ergebnis mit Vorzeichen interpretiert. Daher wird 32768 zu -32768, 65535 zu -1, und NaN sowie Unendlichkeiten werden 0. BigInt beim Schreiben oder ein BigInt Typed Array als Quelle löst TypeError aus. Die Byteordnung ist nativ; für explizites Endianness dient DataView.

Die Länge durchläuft ToIndex: Brüche werden abgeschnitten, NaN/undefined werden 0 und -0.5 ergibt 0. Negatives Ergebnis nach ToIntegerOrInfinity, Unendlichkeit, falsch ausgerichteter Offset oder Bereich außerhalb des Puffers ergibt RangeError; ein abgelöster Puffer TypeError. Der Typ ist seit ECMAScript 2015 standardisiert.

Beispiele

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

Ergebnis

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

Quellen