Node.js - Buffer.readBigInt64LE() 方法



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

对有符号、无符号整数和 2 的补码有一点了解。

有符号 64 位整数的最小值为 -9,223,372,036,854,775,808,最大值为 9,223,372,036,854,775,807。而无符号 64 位整数的最小值为 0,最大值为 264-1。

有符号整数可以取正值和负值,而无符号整数只有正值。

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

二进制文件: 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.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'