Node.js - Buffer.readUInt8() 方法



Node.JS Buffer.readUInt8() 方法有助于在给定偏移量处读取当前缓冲区对象的 8 位无符号数。使用 8 位时,unsigned 的值范围为 0 到 255。对于有符号,它是 -128 到 127。

语法

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


 buf.readUInt8([offset])

参数

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

返回值

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

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


const buffer = Buffer.from([1, 2 ,3, 4, 5, 6, 7, 8]);
console.log("buffer length is ", buffer.length); 	
console.log("Reading integer at offset 5:", buffer.readUInt8(5));

输出

可以使用的偏移量是缓冲区的长度 −1。所以在上面的例子中,我们可以使用 0 到 7。我们使用 offset 作为 5,因此将返回第 5 个位置的 8 位无符号整数。如果给出的偏移量大于 7,则将给出误差ERR_OUT_OF_RANGE。

buffer length is 8
Reading integer at offset 5: 6

在下面的示例中,将使用 buffer.from() 中的字符串。


const buffer = Buffer.from("Hello World");
console.log("buffer length is ", buffer.length); 	
console.log("Reading integer at offset 2:", buffer.readUInt8(2));

输出

在上面的示例中,创建的缓冲区的长度为 11。因此,对于偏移量,我们可以使用 0 到 10 之间的值。

buffer length is 11
Reading integer at offset 2: 108

此示例将检查偏移量是否大于 buffer.length-1 的错误。让我们创建一个长度为 8 的缓冲区,这样,您可以将该值偏移为 0 到 7。


const buffer = Buffer.from([1, 2 ,3, 4, 5, 6, 7, 8]);
console.log("buffer length is ", buffer.length); 	
console.log("Reading at big integer at offset 8:", buffer.readUInt8(8));

输出

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

buffer length is 8
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 <= 7. Received 8
at boundsError (internal/buffer.js:58:9)
at Buffer.readUInt8 (internal/buffer.js:148:5)
at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:3:59)
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