Node.js - Buffer.readDoubleBE() 方法

Node.JS Buffer.readDoubleBE() 方法用于从当前缓冲区对象中给定偏移量处读取一个大端序双精度 64 位数。

双精度 64 位数也称为 FP64 或 float64。使用时，它在计算机中占用 64 位内存。

双精度 64 位数分为符号位、指数位和尾数位。符号位占 1 位，指数位占 11 位，其余 53 位（其中 52 位用于显式存储）由尾数位占用。

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

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

• 尾数位是 53 位。例如，一个数字是 120.53。因此，这里的整数 12053 是尾数，$10^{-2}$ 是幂项，其中 -2 是指数。

语法

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

buf.readDoubleBE([offset])

参数

• offset - 指示开始读取位置的偏移量。偏移量大于或等于 0，也小于或等于 buffer.length-8。默认值为 0。

返回值

此方法返回当前缓冲区中给定偏移量处的 64 位大端序双精度数。

示例

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

const buffer = Buffer.from([11, 12, 13, 14, 15, 16, 17, 18]);
console.log(buffer.readDoubleBE(0));

输出

我们在此方法中使用的偏移量为 0。将返回第 0 位上的 64 位双精度大端序数。上面创建的缓冲区长度为 8。因此，我们只能使用值为 0 的偏移量。如果任何值 >0，它将给出错误 ERR_OUT_OF_RANGE。

1.8681939987954357e-255
<Buffer 0b 0c 0d 0e 0f 10 11 12>

示例

让我们创建一个 16 位的缓冲区，并查看使用 Node.JS Buffer.readDoubleBE() 方法返回的值。

const buffer = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff,
0xff, 0xff, 0xff, 0xff,0xff, 0xff, 0xff, 0xff]);
console.log("Length of buffer is ", buffer.length);  
console.log("Reading at big integer at offset 2:", buffer.readDoubleBE(2));

输出

在上面的示例中，创建的缓冲区的长度为 16。因此，对于偏移量，我们可以使用 0 到 8 的值。

Length of buffer is 16
Reading at big integer at offset 2: 1.390671161566996e-309

示例

此示例将检查如果偏移量大于 buffer.length -8 时发生的错误。让我们创建一个长度为 8 的缓冲区，并且可以使用 0 作为偏移量值。

const buffer = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
console.log("buffer length is ", buffer.length);  
console.log("Reading at big integer at offset 1:", buffer.readDoubleBE(1));

输出

由于我们在上面的程序中使用了大于 0 的偏移量，因此它将抛出如下所示的错误：

buffer length is 8
internal/buffer.js:58
   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 <= 0. Received 1
   at boundsError (internal/buffer.js:58:9)
   at Buffer.readDoubleBackwards [as readDoubleBE] (internal/buffer.js:442:5)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:3:59)
   at Module._compile (internal/modules/cjs/loader.js:816:30)
   at Object.Module._extensions..js (internal/modules/cjs/loader.js:827:10)
   at Module.load (internal/modules/cjs/loader.js:685:32)
   at Function.Module._load (internal/modules/cjs/loader.js:620:12)
   at Function.Module.runMain (internal/modules/cjs/loader.js:877:12)
   at internal/main/run_main_module.js:21:11