Node.js - Buffer.writeDoubleLE() 方法



Node.JS Buffer.writeDoubleLE() 方法有助于在给定的偏移量处将小端序双数写入创建的缓冲区。

双 64 位也称为 FP64 或 float64。使用时,它会占用计算机中的 64 位内存。

双 64 位被划分为符号、指数和有效精度。符号取 1 位,指数取 11 位,其余 53 位(52 用于显式存储)按有效精度取。

  • 符号位表示数字的符号为正或负。
  • 指数是一个 11 位无符号整数,最小值为 0,最大值为 2047。
  • 有效值为 53 位。例如,数字为 120.53。所以这里的整数值 12053 是有效数,$10^{-2}$ 是幂项,−2 是指数。

语法

以下是Node.JS Buffer.writeDoubleLE()方法的语法 -


 buf.writeDoubleLE(value[, offset])

参数

此方法接受两个参数。下面将对此进行解释。

  • value − (必填) 要写入缓冲区的数字。
  • offset − (可选) 此处的偏移量表示开始写入的位置。偏移量必须大于或等于 0 且小于或等于 buffer.length-8。默认值为 0。

返回值

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

为了创建一个缓冲区,我们将使用 NodeJS Buffer.alloc() 方法 -


const buffer = Buffer.alloc(10);
buffer.writeDoubleLE(167.8989, 0);
console.log(buffer);

输出

我们使用此方法使用的偏移量为 0。在执行时,给定的数字将从第 0 个位置写入创建的缓冲区。为上述创建的缓冲区长度为 10。因此,我们只能使用值从 0 到 2 的偏移量。如果任何值 >2,它将给出错误ERR_OUT_OF_RANGE。

<Buffer fb cb ee c9 c3 fc 64 40 00 00>

在此示例中,将使用大于 buffer.length - 8 的偏移量。它应该抛出一个错误,如下所示。


const buffer = Buffer.alloc(10);
buffer.writeDoubleLE(167.8989, 3);
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 <= 2. Received 3
at boundsError (internal/buffer.js:83:9)
at checkBounds (internal/buffer.js:52:5)
PS C:\nodejsProject> node src/testbuffer.js
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 <= 2. Received 3
at boundsError (internal/buffer.js:83:9)
at checkBounds (internal/buffer.js:52:5)
at Buffer.writeDoubleForwards [as writeDoubleLE] (internal/buffer.js:897: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.writeDoubleLE(167.8989);
console.log(buffer);

输出

偏移量不使用,默认情况下将取为 0。因此,上述的输出如下所示。

<Buffer fb cb ee c9 c3 fc 64 40 00 00>