DataView.prototype.setBigInt64()

The setBigInt64() method of DataView instances takes a BigInt and stores it as a 64-bit signed integer in the 8 bytes starting at the specified byte offset of this DataView.

Try it

Syntax

js

setBigInt64(byteOffset, value)
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 is 2n ** (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 or undefined, a big-endian value is written.

Return value

undefined.

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

js

const buffer = new ArrayBuffer(8);
const dataview = new DataView(buffer);
dataview.setBigInt64(0, 3n);
dataview.getBigInt64(0); // 3n

Specifications

Specification
ECMAScript Language Specification
# sec-dataview.prototype.setbigint64

Browser compatibility

BCD tables only load in the browser

See also