DataView.prototype.setBigInt64()
The setBigInt64()
method stores a signed 64-bit integer
(long long) value at the specified byte offset from the start of the
DataView
.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
dataview.setBigInt64(byteOffset, value [, littleEndian])
Parameters
- byteOffset
- The offset, in bytes, from the start of the view to store the data from.
- value
- The value to set as a
BigInt
. The highest possible value that fits in a signed 64-bit integer is2n ** (64n -1n) - 1n
(9223372036854775807n
). Upon overflow, it will be negative (-9223372036854775808n
). - littleEndian
- Optional Indicates whether the 64-bit int is stored in little- or big-endian format. If
false
orundefined
, a big-endian value is written.
Return value
Errors thrown
RangeError
- Thrown if the
byteOffset
is set such that it would store beyond the end of the view.
Examples
Using the setBigInt64
method
var buffer = new ArrayBuffer(8);
var dataview = new DataView(buffer);
dataview.setBigInt64(0, 3n);
dataview.getBigInt64(0); // 3n
Specifications
Specification |
---|
ECMAScript (ECMA-262) The definition of 'DataView.prototype.setBigInt64()' in that specification. |
Browser compatibility
BCD tables only load in the browser