DataView.prototype.setBigUint64()

setBigUint64() 方法在距 DataView 的起始位置的指定字节偏移处存储一个无符号的 64 位整数(unsigned long long 类型)值。

尝试一下

语法

dataview.setBigUint64(byteOffset, value [, littleEndian])

参数说明

byteOffset

字节偏移量,为从视图的起始位置到数据存储位置的字节字节偏移量。

value

作为一个 BigInt 类型设置的数值。满足一个无符号的 64 位整数的最大可能数值是 2n ** 64n - 1n (18446744073709551615n)。当发生溢出时,将会变成 0。

littleEndian

为可选参数,表示这个 64 位整数是否以 little-endian 或者 big-endian 格式存储。如果设置为 false 或者未指定(undefined),将会写入一个 big-endian(大端模式:高位字节排放在内存的低地址端,低位字节排放在内存的高地址端)格式的数值。

返回值

抛出的错误

RangeError

如果 byteOffset 设置导致存储该数值时超出了视图的末尾位置,将会抛出错误。

示例

使用 setBigUint64 方法

js
var buffer = new ArrayBuffer(8);
var dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(0); // 3n

规范

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

浏览器兼容性

BCD tables only load in the browser

请参阅