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, die beim angegebenen Byte-Offset dieses DataView beginnen. Es gibt keine Ausrichtungsbeschränkung; Mehrbyte-Werte können an beliebiger Stelle 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 Beginn der Ansicht, um die Daten dort zu speichern.
value-
Der Wert, der als
BigIntgesetzt werden soll. Wie der Wert in Bytes codiert wird, finden Sie unter Wertkodierung und -normalisierung. littleEndianOptional-
Gibt an, ob die Daten im Little- oder Big-Endian-Format gespeichert werden. Wenn
falseoderundefined, wird ein Big-Endian-Wert geschrieben.
Rückgabewert
Ausnahmen
RangeError-
Wird ausgelöst, wenn der
byteOffsetso gesetzt ist, dass er über das Ende der Ansicht hinaus speichern würde.
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® 2026 Language Specification # sec-dataview.prototype.setbigint64 |