Node.js Buffer.readUInt16LE() 方法

在 Node.js 中，Buffer.readUInt16LE() 方法用于从 Buffer 对象的指定位置读取一个无符号的 16 位整数值，并按照小端字节序（little-endian）进行解析。

语法

buffer.readUInt16LE(offset)

参数

• offset：读取的起始位置（偏移量）。必须是非负整数。

返回值

返回一个无符号的 16 位整数值。

示例

以下示例演示了如何使用 readUInt16LE() 方法从 Buffer 对象中读取 16 位整数：

const buffer = Buffer.from([0x34, 0x12, 0xFF, 0xAA]);

const value = buffer.readUInt16LE(1);

console.log(value);
// 输出: 4660（0x1234）

说明

• Buffer 对象是 Node.js 中用于处理二进制数据的类。
• readUInt16LE() 方法按照小端字节序（低字节在前，高字节在后）读取 Buffer 中的数据。
• offset 参数指定要读取的起始位置。该位置必须在合法范围内，否则会抛出 RangeError。
• 返回的结果是一个无符号的 16 位整数。因为 JavaScript 中没有无符号整数类型，返回值实际上是一个 32 位带符号整数。
• 如果 Buffer 对象不包含足够的数据进行读取，将会返回一个无效的结果。

注意事项

• readUInt16LE() 方法会改变 Buffer 对象的读取位置。下一次读取操作将从上一次读取的结束位置开始。
• 在读取之前，请确保 Buffer 对象的长度足够，并且 offset 参数指定的位置包含有效的数据。
• 尽量避免在 buffer 的嵌套时使用 readUInt16LE() 方法，因为它无法正确处理多字节数据。

更多关于 Buffer.readUInt16LE() 方法的详细信息，请参阅官方文档： Buffer.readUInt16LE() - Node.js Documentation