Node.js - Buffer.readInt32BE() 方法

NodeJS Buffer.readInt32BE() 方法用於從緩衝區中以大端序讀取指定偏移量處的有符號 32 位整數。從緩衝區讀取的整數以二進位制補碼形式表示。

32 位有符號整數的取值範圍為 −2147483648 到 2147483647。

二進位制補碼是對二進位制數進行的一種數學運算。獲取任何給定二進位制數的二進位制補碼的方法如下：

二進位制數: 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.readInt32BE() 方法的語法：

buf.readInt32BE(offset)

引數

此方法接受一個引數。如下所述。

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

返回值

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

示例

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

const buffer = Buffer.from([0,15,10,12,13,14,22,25]);
console.log("buffer stored in memory as", buffer);  
console.log("Reading 16 bit signed integer at offset 0:", buffer.readInt32BE(0));

輸出

我們在此方法中使用的偏移量為 0。將返回第 0 位處的 32 位有符號整數。上面建立的緩衝區長度為 8。因此，我們只能使用值為 0、1、2 和 3 的偏移量。如果任何值 > 3，則會給出錯誤 ERR_OUT_OF_RANGE。

buffer stored in memory as <Buffer 00 0f 0a 0c 0d 0e 16 19>
Reading 16 bit signed integer at offset 0: 985612

示例

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

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

輸出

Length of buffer is 16
Reading at big integer at offset 2: 33752069

示例

此示例將檢查如果偏移量大於 buffer.length − 4 時出現的錯誤。讓我們建立一個長度為 8 的緩衝區，並使用該緩衝區，您可以將偏移量設定為 0 到 4。在下面的示例中，我們使用偏移量 7，因此它將丟擲錯誤，如輸出所示。

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

輸出

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 7gt;= 0 and <= 4. Received 7
   at boundsError (internal/buffer.js:58:9)
   at Buffer.readInt32BE (internal/buffer.js:378: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