DataView.prototype.getBigInt64()
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 getBigInt64() Methode von DataView Instanzen liest 8 Bytes beginnend ab dem angegebenen Byte-Offset dieses DataView und interpretiert sie als 64-Bit-Vorzeichen-Integer. Es gibt keine Ausrichtungsbeschränkung; Mehrbyte-Werte können von jedem Offset innerhalb der Grenzen abgerufen 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
getBigInt64(byteOffset)
getBigInt64(byteOffset, littleEndian)
Parameter
byteOffset-
Der Offset, in Bytes, vom Anfang der Ansicht, von dem die Daten gelesen werden sollen.
littleEndianOptional-
Gibt an, ob die Daten im Little- oder Big-Endian Format gespeichert sind. Wenn
falseoderundefined, wird ein Big-Endian-Wert gelesen.
Rückgabewert
Ein BigInt im Bereich von -263 bis 263-1, einschließlich.
Ausnahmen
RangeError-
Wird ausgelöst, wenn
byteOffsetso eingestellt ist, dass es über das Ende der Ansicht hinaus lesen würde.
Beispiele
Verwendung von getBigInt64()
const { buffer } = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
const dataview = new DataView(buffer);
console.log(dataview.getBigInt64(1)); // 72623859790382856n
Spezifikationen
| Specification |
|---|
| ECMAScript® 2025 Language Specification # sec-dataview.prototype.getbigint64 |