Node.js - Buffer.writeUInt32LE() 方法

NodeJS 的Buffer.writeUInt32LE()方法用於將給定偏移量處的值（一個無符號的 32 位整數）以小端位元組序的形式寫入緩衝區。如果該值不是一個 32 位無符號整數，則返回 undefined。

語法

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

buf.writeUInt32LE(value[, offset])

引數

此方法接受兩個引數，如下所述。

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

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

返回值

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

示例

為了建立一個緩衝區，我們將使用 Buffer.alloc() 方法：

const buffer = Buffer.alloc(10);
buffer.writeUInt32LE(1000);
console.log(buffer);

輸出

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

<Buffer e8 03 00 00 00 00 00 00 00 00>

示例

在此示例中，我們將使用緩衝區長度為 5，並且偏移量大於 buffer.length −4。

const buffer = Buffer.alloc(5);
buffer.writeUInt32LE(1000, 2);
console.log(buffer);

輸出

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 <= 1. Received 2
   at boundsError (internal/buffer.js:58:9)
   at checkBounds (internal/buffer.js:39:5)
   at checkInt (internal/buffer.js:46:3)
   at writeU_Int32LE (internal/buffer.js:526:3)
   at Buffer.writeUInt32LE (internal/buffer.js:539:10)
   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)

示例

在此示例中，我們將建立一個緩衝區，並從一個在範圍內的偏移量開始寫入。

const buffer = Buffer.alloc(10);
buffer.writeUInt32LE(123, 4);
console.log(buffer);

輸出

偏移量必須在 0 到 6 之間。上述程式碼執行後的輸出如下所示：

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