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 setBigUint64() Methode von DataView Instanzen nimmt ein BigInt und speichert es als 64-Bit-Unsigned-Integer in den 8 Bytes, die beim angegebenen Byte-Offset dieses DataView beginnen. 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 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 Anfang des Views, an dem die Daten gespeichert werden sollen.
value-
Der Wert, der als
BigIntgesetzt werden soll. Für Informationen darüber, wie der Wert in Bytes kodiert ist, siehe Wertkodierung und Normalisierung. littleEndianOptional-
Gibt an, ob die Daten im little-endian 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 wird, dass er über das Ende des Views hinaus speichern 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 |