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

js
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()

js
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

Siehe auch