Node.js - Buffer.writeUIntLE() 方法

NodeJS 的 Buffer.writeUIntLE() 方法用於將指定值的無符號位元組寫入緩衝區中的給定偏移量，以小端序的形式。

語法

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

buf.writeUIntLE(value, offset, bytelength)

引數

此方法接受三個引數。下面將詳細解釋。

• value − (必填) 要寫入緩衝區的無符號數字。

• offset − (必填) 指示開始寫入位置的偏移量。偏移量必須大於或等於 0，並且小於或等於 buffer.length-bytelength。預設值為 0。

• byteLength − (必填) 要寫入的位元組數。byteLength 必須在 0 到 6 之間。

返回值

NodeJS 的 buffer.writeUIntLE() 方法寫入給定值並返回偏移量加上寫入的位元組數。

示例

要建立緩衝區，我們將使用 Buffer.alloc() 方法：

const buffer = Buffer.alloc(10);
buffer.writeUIntLE(123, 0, 6);
console.log(buffer);

輸出

我們使用的偏移量為 0，位元組長度為 6。執行時，從第 0 個位置開始的值將寫入建立的緩衝區。上面建立的緩衝區長度為 10。因此，我們只能使用 0 到 4 之間的偏移量值。如果任何值 >4，則會引發錯誤 ERR_OUT_OF_RANGE。

<Buffer 7b 00 00 00 00 00 00 00 00 00>

示例

在此示例中，我們將使用大於 6 的位元組長度。它應該會丟擲如下所示的錯誤。

const buffer = Buffer.alloc(10);
buffer.writeUIntLE(123, 0, 8);
console.log(buffer);

輸出

internal/buffer.js:58
   throw new ERR_OUT_OF_RANGE(type || 'offset',
   ^
   
PS C:\nodejsProject> node src/testbuffer.js
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
PS C:\nodejsProject> node src/testbuffer.js
internal/buffer.js:58
   throw new ERR_OUT_OF_RANGE(type || 'offset',
   ^
   
RangeError [ERR_OUT_OF_RANGE]: The value of "byteLength" is out of range. It must be >= 1 and <= 6. Received 8
   at boundsError (internal/buffer.js:58:9)
   at Buffer.writeUIntLE (internal/buffer.js:488:3)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:2:8)
   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

示例

在此示例中，我們將使用大於 buffer.length − bytelength 的偏移量。

const buffer = Buffer.alloc(10);
buffer.writeUIntLE(123, 8, 3);
console.log(buffer);

輸出

偏移量必須在 0 到 7 之間。由於我們使用了 8，因此它會丟擲如下所示的錯誤：

internal/buffer.js:58
   throw new ERR_OUT_OF_RANGE(type || 'offset',
   ^
   
PS C:\nodejsProject> node src/testbuffer.js
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 checkBounds (internal/buffer.js:39:5)
   at checkInt (internal/buffer.js:46:3)
   at writeU_Int24LE (internal/buffer.js:544:3)
   at Buffer.writeUIntLE (internal/buffer.js:480:12)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:2:8)
   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)