Node.js - Buffer.readBigUInt64BE() 方法

---

---

Node.JS Buffer.readBigUInt64BE() 方法用于从当前缓冲区对象给定偏移量处读取一个无符号大端 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));

输出

buffer stored in memory as <Buffer 00 00 00 00 ff ff ff ff>
Reading at big unsigned integer at offset 0: 4294967295n

示例

让我们创建一个 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 的值。执行上述代码的输出如下所示：

Length of buffer is 16
Reading at big integer at offset 2: 281474976710655n

示例

此示例将检查如果偏移量大于 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 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.readBigUInt64BE (internal/buffer.js:114: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'
   }  

示例

让我们也检查一下别名函数 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 来获取无符号大整数。

buffer length is 8
Reading at big integer at offset 0: 4294967295n