DataView.prototype.setBigInt64()
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.
**setBigInt64()
**方法在距DataView
的起始位置的指定字节偏移处存储一个带符号的 64 位整数(long long 类型)值。
尝试一下
语法
dataview.setBigInt64(byteOffset, value [, littleEndian])
参数说明
- byteOffset
-
字节偏移量,为从视图的起始位置到数据存储位置的字节字节偏移量。
- value
-
作为一个
BigInt
类型设置的数值。满足一个带符号的 64 位整数的最大可能数值是2n ** (64n -1n) - 1n
(9223372036854775807n
)。当发生溢出时,将会变成负数 (-9223372036854775808n
)。 - littleEndian
-
可选 为可选参数,表示这个 64 位整数是否以little-endian 或者 big-endian格式存储。如果设置为
false
或者未指定(undefined
),将会写入一个 big-endian(大端模式:高位字节排放在内存的低地址端,低位字节排放在内存的高地址端)格式的数值。
返回值
抛出的错误
RangeError
-
如果
byteOffset
设置导致存储该数值时超出了视图的末尾位置,将会抛出错误。
示例
使用 setBigInt64
方法
js
var buffer = new ArrayBuffer(8);
var dataview = new DataView(buffer);
dataview.setBigInt64(0, 3n);
dataview.getBigInt64(0); // 3n
规范
Specification |
---|
ECMAScript Language Specification # sec-dataview.prototype.setbigint64 |
浏览器兼容性
BCD tables only load in the browser