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 Methode setBigInt64() von DataView-Instanzen nimmt ein BigInt und speichert es als 64-Bit vorzeichenbehaftete Ganzzahl in den 8 Bytes, die ab dem angegebenen Byte-Offset dieses DataView beginnen. Es gibt keine Ausrichtungsbeschränkung; Mehrbyte-Werte können an jedem Offset innerhalb der Grenzen gespeichert werden.

Probieren Sie es aus

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

// Highest possible BigInt value that fits in a signed 64-bit integer
const max = 2n ** (64n - 1n) - 1n;

const view = new DataView(buffer);
view.setBigInt64(1, max);

console.log(view.getBigInt64(1));
// Expected output: 9223372036854775807n

Syntax

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

Parameter

byteOffset

Der Versatz in Bytes, vom Start der Ansicht aus, an dem die Daten gespeichert werden sollen.

value

Der Wert, der als BigInt gesetzt werden soll. Informationen darüber, wie der Wert in Bytes codiert wird, finden Sie unter Wertcodierung 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 speichert.

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® 2025 Language Specification
# sec-dataview.prototype.setbigint64

Browser-Kompatibilität

Siehe auch