Node.js - Buffer.readBigUInt64BE() 方法

Node.JS Buffer.readBigUInt64BE（） 方法有助于在给定偏移量处读取当前缓冲区对象的无符号 big-endian 64 位整数。

在计算机编程中，无符号整数是指正整数，有符号整数是指正值和负值。

对于 64 位，无符号整数的最小值为 0，最大值为 $2^{64}$-1。

语法

以下是 Node.JS Buffer.readBigUInt64BE（） 方法的语法 -

 buf.readBigUInt64BE([offset])

参数

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

返回值

此方法返回给定偏移量处当前缓冲区内容的 64 位无符号整数值。

您还可以使用可用的别名函数：buf.readBigUint64BE（offset）。

在以下示例中，我们将创建一个缓冲区，并将使用 NodeJS Buffer.from（） 方法。

我们使用此方法使用的偏移量为 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 unsigned integer at offset 0:",
	buffer.readBigUInt64BE(0));

输出

例

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

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

输出

在上面的示例中，创建的缓冲区的长度为 16。因此，对于偏移量，我们可以使用 0 到 8 的值。上述代码的输出在执行时如下所示 -

例

此示例将检查偏移量是否大于 buffer.length -8 的错误。让我们创建一个长度为 8 的缓冲区，这样，您可以将该值偏移为 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.readBigUInt64BE(1));

输出

由于我们在上述程序中使用了大于 0 的偏移量，因此它将抛出如下所示的错误 -

例

我们还让我们检查别名函数 buffer.readBigUint64BE（） 方法。

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

输出

我们使用偏移量 0 来获取无符号大整数。