DataView.prototype.setBigUint64()

Baseline 已广泛支持

此功能已成熟，并可在多种设备和浏览器版本上运行。自 2021 年 9 月起，所有浏览器均已支持此功能。

DataView 实例的 setBigUint64() 方法接受一个 BigInt，并将其作为 64 位无符号整数存储在该 DataView 从指定字节偏移量开始的 8 个字节中。没有对齐限制；多字节值可以存储在任何边界内的偏移量处。

试一试

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);

// Highest possible BigInt value that fits in an unsigned 64-bit integer
const max = 2n ** 64n - 1n;

const view = new DataView(buffer);
view.setBigUint64(1, max);

console.log(view.getBigUint64(1));
// Expected output: 18446744073709551615n

语法

setBigUint64(byteOffset, value)
setBigUint64(byteOffset, value, littleEndian)

参数

byteOffset: 存储数据的从视图开始处的字节偏移量。
value: 要设置为 BigInt 的值。关于值如何编码为字节，请参阅值编码和规范化。
littleEndian 可选: 指示数据是存储在小端或大端格式中。如果为 false 或 undefined，则写入大端值。

返回值

undefined.

异常

RangeError: 如果 byteOffset 设置为超出视图末尾存储，则会抛出此错误。

示例

使用 setBigUint64()

const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setBigUint64(0, 3n);
dataview.getBigUint64(1); // 768n

规范

规范
ECMAScript® 2026 语言规范 # sec-dataview.prototype.setbiguint64

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025 年 7 月 10 日，由 MDN 贡献者。

在 GitHub 上查看此页面 • 报告此内容的错误