Node.js - Buffer.readInt32BE() 方法



NodeJS Buffer.readInt32BE() 方法有助于以大端形式从缓冲区读取给定偏移量的有符号 32 位整数。从缓冲区读取的整数表示为 2 的补码有符号值。

使用 32 位有符号整数存储的值范围为 −2147483648 到 2147483647。

二的补码是对二进制数的数学运算。为了使任何给定的二进制数的两者完成,它将如下所示 -

二进制文件: 101011

  • 第 1 步 - 首先找到二进制数的补码:101011。要获得一个完整的,您需要将 1 设为 0,将 0 设为 1。所以上述二进制数的 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