The setBigUint64() method of DataView instances takes a BigInt and stores it as a 64-bit unsigned integer in the 8 bytes starting at the specified byte offset of this DataView. There is no alignment constraint; multi-byte values may be stored at any offset within bounds.
Syntax
setBigUint64(byteOffset, value)
setBigUint64(byteOffset, value, littleEndian)
Parameters
byteOffset- : The offset, in bytes, from the start of the view to store the data in.
value- : The value to set as a BigInt. For how the value is encoded in bytes, see Value encoding and normalization.
littleEndian- : Indicates whether the data is stored in little- or big-endian format. If
falseorundefined, a big-endian value is written.
- : Indicates whether the data is stored in little- or big-endian format. If
Return value
Exceptions
- RangeError
- : Thrown if the
byteOffsetis set such that it would store beyond the end of the view.
- : Thrown if the
Examples
Using setBigUint64()
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(1); // 768n