Node.js - Buffer.readBigInt64LE() 方法

---

---

NodeJS 的 Buffer.readBigInt64LE() 方法用於從緩衝區中給定偏移量處讀取一個以小端位元組序表示的有符號 64 位整數。從緩衝區讀取的整數以二進位制補碼的形式表示有符號值。

對有符號整數、無符號整數和二進位制補碼的一些理解。

一個有符號的 64 位整數的最小值為 -9,223,372,036,854,775,808，最大值為 9,223,372,036,854,775,807。而一個無符號的 64 位整數的最小值為 0，最大值為 264-1。

有符號整數可以取正值和負值，而無符號整數只能取正值。

現在來說說二進位制補碼，它是一種對二進位制數進行的數學運算。要獲得任何給定二進位制數的二進位制補碼，步驟如下：

二進位制數: 101011

• 步驟 1 - 首先找到二進位制數 101011 的反碼。要得到反碼，你需要將 1 變成 0，將 0 變成 1。所以上面二進位制數的反碼是：010100。

• 步驟 2 - 現在，對步驟 1 中的反碼加 1。

I.e. 010100 + 1 = 010101. So 010101 is the two's complement of binary number 101011.

語法

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

buf.readBigInt64LE(offset)

引數

此方法接受一個引數。下面解釋一下。

• offset - 此處的偏移量指示開始讀取的位置。偏移量必須大於或等於 0，小於或等於 buffer.length-8。預設值為 0。

返回值

此方法返回當前緩衝區中給定偏移量處的 64 位有符號整數值。

示例

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

const buffer = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
console.log("buffer stored in memory as", buffer);  
console.log("Reading at big integer at offset 0:", buffer.readBigInt64LE(0));

輸出

我們在此方法中使用的偏移量為 0。執行時，將返回第 0 位的 64 位有符號整數。上面建立的緩衝區長度為 8。因此，我們只能將偏移量值設定為 0。如果任何值 >0，則會報錯 ERR_OUT_OF_RANGE。

buffer stored in memory as <Buffer 00 00 00 00 ff ff ff ff>
Reading at big integer at offset 0: -4294967296n

示例

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

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 0:", buffer.readBigInt64LE(2));

輸出

Length of buffer is 16
Reading at big integer at offset 0: -65536n

在上面的示例中，建立的緩衝區的長度為 16。因此，對於偏移量，我們可以使用 0 到 8 的值。當偏移量為 8 時，輸出如下：

Length of buffer is 16
Reading at big integer at offset 8: -1n

示例

此示例將檢查如果偏移量大於 buffer.length -8 時出現的錯誤。讓我們建立一個長度為 8 的緩衝區，並使用該緩衝區將偏移量設定為 1。

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.readBigInt64LE(1));

輸出

buffer length is  8
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 <= 0. Received 1
   at boundsError (internal/buffer.js:83:9)
   at Buffer.readBigInt64LE (internal/buffer.js:134:5)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:3:59)
   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'