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'