DataView.prototype.setInt16()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die setInt16()-Methode von DataView-Instanzen nimmt eine Zahl und speichert sie als 16-Bit-Ganzzahl mit Vorzeichen in den 2 Bytes, beginnend bei dem angegebenen Byte-Offset dieses DataView. Es gibt keine Ausrichtungsbeschränkung; Multi-Byte-Werte können an jedem Versatz innerhalb der Grenzen gespeichert werden.

Probieren Sie es aus

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);

const view = new DataView(buffer);
view.setInt16(1, 32767); // Max signed 16-bit integer

console.log(view.getInt16(1));
// Expected output: 32767

Syntax

js
setInt16(byteOffset, value)
setInt16(byteOffset, value, littleEndian)

Parameter

byteOffset

Der Offset, in Bytes, vom Beginn der Ansicht, wo die Daten gespeichert werden sollen.

value

Der Wert, der gesetzt werden soll. Wie der Wert in Bytes codiert wird, finden Sie unter Wertkodierung und Normalisierung.

littleEndian Optional

Gibt an, ob die Daten im Little- oder Big-Endian Format gespeichert werden. Wenn false oder undefined, wird ein Big-Endian-Wert geschrieben.

Rückgabewert

Ausnahmen

RangeError

Wird ausgelöst, wenn byteOffset so gesetzt ist, dass es über das Ende der Ansicht hinaus gespeichert würde.

Beispiele

Verwendung von setInt16()

js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setInt16(0, 3);
dataview.getInt16(1); // 768

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-dataview.prototype.setint16

Browser-Kompatibilität

Siehe auch