Node.js - Buffer.readUInt8() 方法

Node.JS Buffer.readUInt8() 方法用於從當前緩衝區物件中給定偏移量處讀取一個 8 位無符號整數。對於 8 位無符號整數，取值範圍為 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。我們使用了 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