Node.js - Buffer.readBigInt64BE（） 方法

NodeJS Buffer.readBigInt64BE（） 方法有助于从缓冲区对象读取给定偏移量的有符号大端序 64 位整数。

• 有符号的 64 位整数是 264-1。结果将是一个 20 位数字。
• 可以以 64 位存储的最小值为：-9,223,372,036,854,775,808。
• 64位可以存储的最大值为：9,223,372,036,854,775,807。

在 Big endian 系统中，它将最高有效字节存储在最低的存储地址。而 Little endian 是一个系统，其中最低有效字节位于最高的存储地址。

请注意，此方法从节点版本 12.0.0 开始可用。

语法

以下是NodeJS readBigInt64BE（）方法的语法 -

 buf.readBigInt64LE(offset)

参数

buf.readBigInt64LE（） 方法接受单个参数。下面将对此进行解释。

• offset - 指示开始读取的位置的偏移量。偏移量大于或等于 0，也小于或等于 buffer.length-8。默认值为 0。

返回值

buf.readBigInt64LE（） 方法在给定的偏移量处返回 64 位有符号整数值。

在以下示例中，我们与 buffer.readBigInt64BE（） 方法一起使用的偏移量为 0。将返回第 0 位的 64 位有符号整数。为上述创建的缓冲区长度为 8。所以我们只能使用值为 0 的偏移量。如果任何值>0，它将给出错误ERR_OUT_OF_RANGE。

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.readBigInt64BE(0));

输出

例

让我们创建一个 16 位的缓冲区，并查看使用 readBigInt64BE（） 方法返回的值。

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.readBigInt64BE(2));

创建的缓冲区长度以上为 16。因此，对于偏移量，我们可以使用 0 到 8 之间的值。

输出

例

在此示例中，如果偏移量大于 buffer.length -8，将检查错误。让我们创建一个长度为 8 的缓冲区，您可以使用它来偏移值为 0。使用大于 0 的偏移量将引发错误，如下所示。

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

输出