Node.js - Buffer.readUInt16LE() 方法

NodeJS 的Buffer.readUInt16LE()方法用於從緩衝區中以小端序讀取指定偏移量處的無符號16位整數。無符號整數始終為非負數。

一個無符號16位整數可以儲存0到65,535範圍內的值。

語法

以下是Node.JS Buffer.readUInt16LE() 方法的語法：

buf.readUInt16LE(offset)

引數

• offset - 指示開始讀取位置的偏移量。偏移量大於等於0且小於等於buffer.length-2。預設值為0。

返回值

此方法返回緩衝區中給定偏移量處的16位無符號整數值。

示例

要建立一個緩衝區，我們將使用NodeJS Buffer.from() 方法：

const buffer = Buffer.from([0,15,10,12]);
console.log("buffer stored in memory as", buffer);  
console.log("Reading 16 bit unsigned integer at offset 0:", buffer.readUInt16LE(0));

輸出

我們在此方法中使用的偏移量為0。將返回第0位上的16位無符號整數。上面建立的緩衝區長度為4。因此，我們只能使用值為0、1和2的偏移量。如果任何值>2，則會給出錯誤ERR_OUT_OF_RANGE。

buffer stored in memory as <Buffer 00 0f 0a 0c>
Reading 16 bit unsigned integer at offset 0: 3840

示例

讓我們建立一個具有16位長度的緩衝區，並檢視使用Node.JS Buffer.readUInt16LE()方法返回的值。

const buffer = Buffer.from([0, 1, 2, 3, 4, 5, 6, 7,8, 9, 10, 11,12, 13, 14, 15]);
console.log("Length of buffer is ", buffer.length);  
console.log("Reading at big integer at offset 2:", buffer.readUInt16LE(2));

輸出

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

示例

此示例將檢查如果偏移量大於buffer.length - 2時出現的錯誤。讓我們建立一個長度為8的緩衝區，這樣你可以使用0到6的偏移量。在下面的示例中，我們使用偏移量7，因此它將丟擲錯誤，如輸出所示。

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 7:", buffer.readUInt16LE(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. ReceivePS C:\nodejsProject> node src/testbuffer.js
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 <= 6. Received 7
   at boundsError (internal/buffer.js:58:9)
   at Buffer.readUInt16LE (internal/buffer.js:139: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