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 einen BigInt und speichert ihn als 64-Bit-Unsigned-Integer in den 8 Bytes, die beim angegebenen Byte-Offset dieser DataView beginnen. Es gibt keine Ausrichtungsbeschränkung; mehrbyteige Werte können an jedem Offset innerhalb der Grenzen gespeichert werden.

Probieren Sie es aus

Syntax

setBigUint64(byteOffset, value)
setBigUint64(byteOffset, value, littleEndian)

Parameter

byteOffset: Der Offset in Bytes vom Anfang der Ansicht, in dem die Daten gespeichert werden sollen.
value: Der Wert, der als BigInt gesetzt werden soll. Wie der Wert in Bytes kodiert wird, siehe Wertkodierung und Normalisierung.
littleEndian Optional: Gibt an, ob die Daten im Little- oder Big-Endian-Format gespeichert werden. Wenn false oder undefined, wird ein Big-Endian-Wert geschrieben.

Rückgabewert

undefined.

Ausnahmen

RangeError: Wird ausgelöst, wenn der byteOffset so gesetzt wird, dass er über das Ende der Ansicht hinaus speichert.

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 Language Specification # sec-dataview.prototype.setbiguint64

Browser-Kompatibilität

BCD tables only load in the browser