Node.js - Buffer.writeFloatLE() 方法

Node.JS Buffer.writeFloatLE() 方法用于将一个小端序的 32 位浮点数写入当前缓冲区对象的指定偏移量处。

32 位浮点数也称为 FP32 或 float32。使用时，它在计算机中占用 32 位内存。

32 位浮点数被划分为符号位、指数位和尾数位。符号位占用 1 位，指数位占用 8 位，其余 24 位（其中 23 位用于显式存储）由尾数位占用。

• 符号位表示数字的正负号。

• 指数位是一个 8 位无符号整数，最小值为 0，最大值为 255。

• 尾数位是 24 位。例如，一个数字是 125.3。因此，这里的整数 1253 是尾数，$10^{-1}$ 是幂项，-1 是指数。

语法

以下是 Node.JS Buffer.writeFloatLE() 方法 的语法：

buf.writeFloatLE(value[, offset])

参数

此方法接受两个参数。下面解释了这两个参数。

• value − （必填）要写入缓冲区的值。

• offset − （可选）此处的偏移量指示开始写入的位置。偏移量大于或等于 0，并且小于或等于 buffer.length-4。默认值为 0。

返回值

Buffer.writeFloatLE() 方法写入给定值并返回偏移量加上写入的字节数。

示例

要创建缓冲区，我们将使用 NodeJS Buffer.alloc() 方法：

const buffer = Buffer.alloc(10);
buffer.writeFloatLE(0xfeaabe, 0);
console.log(buffer);

输出

我们使用的偏移量是 0。执行时，从第 0 位开始的值将被写入创建的缓冲区。上面创建的缓冲区长度为 10。因此，我们只能使用 0 到 6 之间的偏移量值。如果任何值 >6，它将引发错误 ERR_OUT_OF_RANGE。

<Buffer be aa 7e 4b 00 00 00 00 00 00>

示例

在此示例中，我们将使用一个大于 buffer.length − 4 的偏移量。它应该抛出如下所示的错误。

const buffer = Buffer.alloc(10);
buffer.writeFloatLE(0xfeaabe, 7);
console.log(buffer);

输出

internal/buffer.js:83
   throw new ERR_OUT_OF_RANGE(type || 'offset',
   ^
   
RangeError [ERR_OUT_OF_RANGE]: The value of "offset" is out of range. It must be >= 0 and <= 6. Received 7
   at boundsError (internal/buffer.js:83:9)
   at checkBounds (internal/buffer.js:52:5)
   at Buffer.writeFloatForwards [as writeFloatLE] (internal/buffer.js:929:3)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:2:8)
   at Module._compile (internal/modules/cjs/loader.js:1063:30)
   at Object.Module._extensions..js (internal/modules/cjs/loader.js:1092:10)
   at Module.load (internal/modules/cjs/loader.js:928:32)
   at Function.Module._load (internal/modules/cjs/loader.js:769:14)
   at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:72:12)
   at internal/main/run_main_module.js:17:47 {
      code: 'ERR_OUT_OF_RANGE'
   }

示例

要创建缓冲区，我们将使用 Buffer.allocUnsafe() 方法：

const buffer = Buffer.allocUnsafe(10);
buffer.writeFloatLE(0xfeaabe);
console.log(buffer);

输出

未使用偏移量，默认情况下它将被视为 0。因此，上面的输出如下所示。

<Buffer be aa 7e 4b 01 00 00 00 00 00>