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

浏览器兼容性

另见