DataView.prototype.setFloat16()

基準線 2025
新推出

自 ⁨2025 年 4 月⁩起,此功能適用於最新裝置和瀏覽器版本。此功能可能不適用於較舊的裝置或瀏覽器。

setFloat16() 方法是 DataView 例項的一部分,它接受一個數字並將其以 16 位浮點數格式儲存在該 DataView 指定位元組偏移量開始的 2 個位元組中。沒有對齊限制;多位元組值可以儲存在任何邊界內的偏移量處。

試一試

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

const view = new DataView(buffer);
view.setFloat16(1, Math.PI);

console.log(view.getFloat16(1));
// Expected output: 3.140625

語法

js
setFloat16(byteOffset, value)
setFloat16(byteOffset, value, littleEndian)

引數

byteOffset

儲存資料的從檢視開始處的位元組偏移量。

value

要設定的值。有關值如何編碼為位元組的資訊,請參閱 值編碼和規範化

littleEndian 可選

指示資料是儲存在 小端 或大端格式中。如果為 falseundefined,則寫入大端值。

返回值

undefined.

異常

RangeError

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

示例

使用 setFloat16()

js
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setFloat16(0, 3);
dataview.getFloat16(1); // 0

規範

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

瀏覽器相容性

另見