Node.js - Buffer.writeUInt16LE() 方法

NodeJS 的Buffer.writeUInt16LE()方法用于将给定偏移量处的值（一个无符号的 16 位整数）以小端字节序的形式写入缓冲区。如果该值不是一个 16 位无符号整数，则返回 undefined。

语法

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

buf.writeUInt16LE(value[, offset])

参数

此方法接受两个参数。下面解释了这两个参数。

• value - (必需)要写入缓冲区的无符号 16 位数字。

• offset - 指示开始写入位置的偏移量。偏移量必须大于或等于 0，并且小于或等于 buffer.length-2。默认值为 0。

返回值

buffer.writeUInt16LE()方法写入给定值并返回偏移量加上写入的字节数。

示例

要创建缓冲区，我们将使用 NodeJS Buffer.alloc() 方法：

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

输出

执行后，从第 0 位开始的值将被写入创建的缓冲区。上面创建的缓冲区长度为 10。因此，我们只能使用 0 到 8 的偏移量值。如果任何值大于 8，则会产生ERR_OUT_OF_RANGE错误。

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

示例

在此示例中，我们将使用缓冲区长度为 5，并且偏移量大于 buffer.length - 2。

const buffer = Buffer.alloc(5);
buffer.writeUInt16LE(1000, 5);
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 <= 3. Received 5
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 <= 3. Received 5
   at boundsError (internal/buffer.js:58:9)
   at checkBounds (internal/buffer.js:39:5)
   at checkInt (internal/buffer.js:46:3)
   at writeU_Int16LE (internal/buffer.js:556:3)
   at Buffer.writeUInt16LE (internal/buffer.js:564: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.writeUInt16LE(123, 4);
console.log(buffer);

输出

偏移量必须在 0 到 8 之间。执行上述代码的输出如下所示：

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