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-Ganzzahl mit Vorzeichen in den 8 Bytes, die beim angegebenen Byte-Offset dieser DataView beginnen. Es gibt keine Ausrichtungsbeschränkung; Mehrbytewerte 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

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

Parameter

byteOffset: Der Offset in Bytes, vom Anfang der Ansicht, um die Daten darin zu speichern.
value: Der als BigInt zu setzende Wert. Wie der Wert in Bytes kodiert 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

undefined.

Ausnahmen

RangeError: Wird ausgelöst, wenn der byteOffset so gesetzt ist, dass er über das Ende der Ansicht hinaus speichert.

Beispiele

Verwendung von setBigInt64()

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