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, beginnend bei dem angegebenen Byte-Offset dieses DataView. 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
setBigInt64(byteOffset, value)
setBigInt64(byteOffset, value, littleEndian)
Parameter
byteOffset-
Der Offset, in Bytes, vom Anfang der Ansicht, um die Daten zu speichern.
value-
Der Wert, der als
BigIntgesetzt werden soll. Informationen darüber, wie der Wert in Bytes codiert wird, finden Sie unter Wertcodierung 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 gespeichert 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 |