DataView.prototype.setBigInt64()

Baseline 已廣泛支援

此功能已成熟，並可在多種裝置和瀏覽器版本上執行。自 2021 年 9 月起，所有瀏覽器均已支援此功能。

DataView 例項的 setBigInt64() 方法接收一個 BigInt，並將其作為 64 位有符號整數儲存在 `DataView` 中指定位元組偏移量開始的 8 個位元組內。沒有對齊限制；多位元組值可以儲存在邊界內的任何偏移量處。

試一試

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

// Highest possible BigInt value that fits in a signed 64-bit integer
const max = 2n ** (64n - 1n) - 1n;

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

console.log(view.getBigInt64(1));
// Expected output: 9223372036854775807n

語法

setBigInt64(byteOffset, value)
setBigInt64(byteOffset, value, littleEndian)

引數

byteOffset: 儲存資料的從檢視開始處的位元組偏移量。
value: 要設定為 BigInt 的值。關於值如何編碼為位元組，請參閱值編碼和歸一化。
littleEndian 可選: 指示資料是儲存在小端或大端格式中。如果為 false 或 undefined，則寫入大端值。

返回值

undefined.

異常

RangeError: 如果 byteOffset 設定為超出檢視末尾儲存，則會丟擲此錯誤。

示例

使用 setBigInt64()

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

規範

規範
ECMAScript® 2026 語言規範 # sec-dataview.prototype.setbigint64

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025 年 7 月 10 日，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題