大网数据广告活动
Web 标准与前端开发

DataView.prototype.setBigUint64()

· 52CE 我爱测

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

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

JavaScript Demo: DataView.setBigUint64()

// 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

语法

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

参数说明

  • byteOffset
    • : 字节偏移量,为从视图的起始位置到数据存储位置的字节字节偏移量。
  • value
    • : 作为一个 BigInt 类型设置的数值。满足一个无符号的 64 位整数的最大可能数值是 2n ** 64n - 1n (18446744073709551615n)。当发生溢出时,将会变成 0。
  • littleEndian
    • : 为可选参数,表示这个 64 位整数是否以 little-endian 或者 big-endian 格式存储。如果设置为 false 或者未指定(undefined),将会写入一个 big-endian(大端模式:高位字节排放在内存的低地址端,低位字节排放在内存的高地址端)格式的数值。

返回值

undefined.

抛出的错误

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

示例

使用 setBigUint64 方法

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

规范

浏览器兼容性

请参阅

  • DataView
  • ArrayBuffer
  • BigInt

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。