Node.js - Buffer.readUIntBE() 方法



NodeJS Buffer.readUIntBE() 方法将根据字节长度和偏移量读取字节数,并从使用的缓冲区中以 big endian 格式返回无符号整数。

语法

以下是Node.JS Buffer.readUIntBE()方法的语法 -


 buf.readUIntBE(offset, byteLength)

参数

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

  • offset - 指示开始读取的位置的偏移量。偏移量大于或等于 0,也小于或等于 buffer.length-bytelength。默认值为 0。
  • byteLength − 您要读取的字节数。byteLength 必须介于 0 到 6 之间。

返回值

此方法以 big endian 格式返回无符号整数,其字节长度为缓冲区的给定偏移值处的字节数。

为了创建一个缓冲区,我们将使用 NodeJS Buffer.from() 方法 -


const buffer = Buffer.from([11, 12, 13, 14, 15, 16]);
console.log(buffer);
console.log(buffer.readUIntBE(0, 2));

输出

我们使用此方法使用的偏移量为 0。使用的字节长度为 2。因此,从第 0 个偏移量开始,它将读取字节长度为 2 的字节,并以大端格式返回结果。

<Buffer 0b 0c 0d 0e 0f 10>
2828

在这个例子中,让我们以十六进制形式打印我们得到的输出,如下所示 -


const buffer = Buffer.from([11, 12, 13, 14, 15, 16]);
console.log(buffer);
console.log(buffer.readUIntBE(0, 2).toString(16));

输出

<Buffer 0b 0c 0d 0e 0f 10>
b0c

正如我们所知,我们可以使用从 0 到 buffer.length-bytelength 的偏移量。因此,如果缓冲区长度为 6,使用的字节长度为 6,则可以使用偏移量为 0。使用大于 0 的值将产生错误:ERR_OUT_OF_RANGE。


const buffer = Buffer.from([11, 12, 13, 14, 15, 16]);
console.log(buffer);
console.log("The buffer length is :"+ buffer.length);
console.log(buffer.readUIntBE(1, 6).toString(16));

输出

<Buffer 0b 0c 0d 0e 0f 10>
The buffer length is :6
internal/buffer.js:58
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:58:9)
at readUInt48BE (internal/buffer.js:177:5)
at Buffer.readUIntBE (internal/buffer.js:157:12)
at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:5:20)
at Module._compile (internal/modules/cjs/loader.js:816:30)
at Object.Module._extensions..js (internal/modules/cjs/loader.js:827:10)
at Module.load (internal/modules/cjs/loader.js:685:32)
at Function.Module._load (internal/modules/cjs/loader.js:620:12)
at Function.Module.runMain (internal/modules/cjs/loader.js:877:12)
at internal/main/run_main_module.js:21:11