DataView.prototype.setBigUint64()
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.
Try it
Syntax
js
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
Optional-
Indicates whether the data is stored in little- or big-endian format. If
false
orundefined
, a big-endian value is written.
Return value
Exceptions
RangeError
-
Thrown if the
byteOffset
is set such that it would store beyond the end of the view.
Examples
Using setBigUint64()
js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(1); // 768n
Specifications
Specification |
---|
ECMAScript Language Specification # sec-dataview.prototype.setbiguint64 |
Browser compatibility
BCD tables only load in the browser