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 上檢視此頁面 • 報告此內容的錯誤