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 ab dem angegebenen Byte-Offset dieses DataView
und interpretiert sie als 64-Bit-Ganzzahl mit Vorzeichen. Es gibt keine Ausrichtungsbeschränkung; Mehrbyte-Werte können von jedem gültigen Offset aus 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 ab dem Anfang der Ansicht, von dem aus die Daten gelesen werden.
littleEndian
Optional-
Gibt an, ob die Daten im Little- oder Big-Endian-Format gespeichert sind. Wenn
false
oderundefined
, wird ein Big-Endian-Wert gelesen.
Rückgabewert
Ein BigInt
von -263 bis 263-1, einschließlich.
Ausnahmen
RangeError
-
Wird ausgelöst, wenn der
byteOffset
so gesetzt wird, dass er über das Ende der Ansicht hinauslesen 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® 2026 Language Specification # sec-dataview.prototype.getbigint64 |