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 ab 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
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 zu setzende Wert als
BigInt
. Wie der Wert in Bytes kodiert wird, sehen Sie unter Wertkodierung und Normalisierung. littleEndian
Optional-
Gibt an, ob die Daten im Little- oder Big-Endian-Format gespeichert werden. Wenn
false
oderundefined
, wird ein Big-Endian-Wert geschrieben.
Rückgabewert
Ausnahmen
RangeError
-
Wird ausgelöst, wenn
byteOffset
so gesetzt wird, dass es ü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 Language Specification # sec-dataview.prototype.setbigint64 |
Browser-Kompatibilität
BCD tables only load in the browser