Node.js - Buffer.readBigUInt64LE（） 方法

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

在计算机编程中，无符号整数是指正整数，有符号整数是指正值和负值。对于 64 位，无符号整数的最小值为 0，最大值为 264-1。

语法

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

buf.readBigUInt64LE([offset])

参数

此方法接受单个参数。下面将对此进行解释。

• offset − 偏移量表示从缓冲区开始读取的位置。偏移量介于 0 到 buffer.length-8 之间。默认值为 0。

返回值

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

您还可以使用可用的别名函数：buf.readBigUint64LE（offset）。这里的函数 （I） 是小写的。

为了创建一个缓冲区，我们将使用 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 unsigned integer at offset 0:", buffer.readBigUInt64LE(0));

输出

我们使用此方法使用的偏移量为 0。将返回第 0 个位置的 64 位无符号整数。为上述创建的缓冲区长度为 8。因此，我们只能使用值为 0 的偏移量。如果任何值 >0，它将给出错误ERR_OUT_OF_RANGE。

例

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

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

输出

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

例

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

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

输出

我们使用偏移量 0 来获取无符号大整数。在执行上述程序时，它将生成以下输出 -