Node.js - Buffer.readFloatLE() 方法

Node.JS Buffer.readFloatLE() 方法用於從當前緩衝區物件中給定偏移量讀取小端序 32 位浮點數。

32 位浮點數也稱為 FP32 或 float32。使用時，它在計算機中佔用 32 位記憶體。

32 位浮點數分為符號位、指數位和尾數位。符號位佔用 1 位，指數位佔用 8 位，其餘 24 位（其中 23 位用於顯式儲存）由尾數位佔用。

• 符號位表示數字的正負號。

• 指數位是一個 8 位無符號整數，最小值為 0，最大值為 255。

• 尾數位為 24 位。例如，數字為 125.3。這裡整數 1253 是尾數，$10^{−1}$ 是冪項，-1 是指數。

語法

以下是 **Node.JS Buffer.readFloatLE() 方法** 的語法：

buf.readFloatLE([offset])

引數

• **offset** − 指示開始讀取位置的偏移量。偏移量大於或等於 0，也小於或等於 buffer.length−4。預設值為 0。

返回值

此方法從當前緩衝區中給定偏移量返回 32 位小端序浮點數。

示例

要建立緩衝區，我們將使用 NodeJS **Buffer.from()** 方法：

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

輸出

我們在此方法中使用的偏移量為 0。將返回第 0 位的 32 位小端序浮點數。上面建立的緩衝區長度為 8。因此我們只能使用值為 0 到 4 的偏移量。如果任何值 > 0，它將給出錯誤 ERR_OUT_OF_RANGE。

1.7385390296684153e-30
<Buffer 0b 0c 0d 0e 0f 10 11 12>

示例

讓我們建立一個 16 位緩衝區，並檢視使用 **Node.JS Buffer.readFloatLE() 方法** 返回的值。

const buffer = Buffer.from([1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16]);
console.log("Length of buffer is ", buffer.length);  
console.log("Reading at big integer at offset 1:", buffer.readFloatLE(1));

輸出

在上例中，建立的緩衝區長度為 16。因此，對於偏移量，我們可以使用 0 到 12 的值。

Length of buffer is  16
Reading at big integer at offset 1: 6.207162620248253e-36

示例

此示例將檢查如果偏移量大於 buffer.length - 4 是否會出錯。讓我們建立一個長度為 8 的緩衝區，並且可以使用 0 到 4 的偏移量值。

const buffer = Buffer.from([1, 2 ,3, 4, 5, 6, 7, 8]);
console.log("buffer length is ", buffer.length);  
console.log("Reading at big integer at offset 5:", buffer.readFloatLE(5));

輸出

由於我們在上述程式中使用了大於 4 的偏移量，因此它將丟擲如下所示的錯誤：

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 <= 4. Received 5
   at boundsError (internal/buffer.js:58:9)
   at Buffer.readFloatForwards [as readFloatLE] (internal/buffer.js:428: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