DataView.prototype.setBigInt64()

Baseline Widely available

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

Die setBigInt64()-Methode von DataView-Instanzen nimmt ein BigInt und speichert es als 64-Bit-Ganzzahl mit Vorzeichen in den 8 Bytes ab dem angegebenen Byte-Offset dieses DataView. Es gibt keine Ausrichtungsbeschränkung; Mehrbyte-Werte können an jedem Offset innerhalb der Grenzen gespeichert werden.

Probieren Sie es aus

Syntax

js
setBigInt64(byteOffset, value)
setBigInt64(byteOffset, value, littleEndian)

Parameter

byteOffset

Der Offset, in Bytes, vom Anfang der Ansicht, um die Daten zu speichern.

value

Der zu setzende Wert als BigInt. Wie der Wert in Bytes kodiert wird, sehen 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 wird, dass es über das Ende der Ansicht hinaus speichern würde.

Beispiele

Verwendung von setBigInt64()

js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigInt64(0, 3n);
dataview.getBigInt64(1); // 768n

Spezifikationen

Specification
ECMAScript Language Specification
# sec-dataview.prototype.setbigint64

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch