DataView.prototype.setBigUint64()
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 Methode setBigUint64()
von DataView
-Instanzen nimmt einen BigInt
-Wert und speichert ihn als 64-Bit-unsigned Integer in den 8 Bytes, die an dem angegebenen Byte-Offset dieses DataView
beginnen. Es gibt keine Ausrichtungsbeschränkung; mehrbyteige 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 an unsigned 64-bit integer
const max = 2n ** 64n - 1n;
const view = new DataView(buffer);
view.setBigUint64(1, max);
console.log(view.getBigUint64(1));
// Expected output: 18446744073709551615n
Syntax
setBigUint64(byteOffset, value)
setBigUint64(byteOffset, value, littleEndian)
Parameter
byteOffset
-
Der Offset in Bytes, vom Beginn des Views, an dem die Daten gespeichert werden.
value
-
Der Wert, der als
BigInt
gesetzt werden soll. Wie der Wert in Bytes enkodiert wird, finden Sie unter Value encoding and normalization. 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 der
byteOffset
so eingestellt ist, dass er über das Ende des Views hinaus gespeichert würde.
Beispiele
Verwendung von setBigUint64()
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(1); // 768n
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-dataview.prototype.setbiguint64 |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setBigUint64 |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support