Node.js - Buffer.readInt8() 方法

Node.JS Buffer.readInt8() 方法用于从当前缓冲区对象中给定偏移量处读取一个 8 位有符号数。

8 位有符号数的值范围为 -128 到 127。8 位无符号数的值范围为 0 到 255。

语法

以下是 Node.JS Buffer.readInt8() 方法 的语法：

buf.readInt8([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.readInt8(5));

输出

可使用的偏移量为缓冲区长度减 1。因此，在上面的示例中，我们可以使用 0 到 7，并且将返回第 5 个位置的 8 位整数。如果提供的偏移量大于 7，则会引发 ERR_OUT_OF_RANGE 错误。

buffer length is 8
Reading at big 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.readInt8(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.readInt8(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.readInt8 (internal/buffer.js:320: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