Node.js Buffer.readIntLE() 方法

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，可以让 JavaScript 代码运行在服务器端。Buffer 类是 Node.js API 中的一个重要组成部分，它用于处理二进制数据。

Buffer.readIntLE() 方法用于从 Buffer 对象中读取指定字节数的整数值，返回一个数字类型的结果。该方法按照小端（Little Endian）字节序读取。字节序是指多个字节存储时的顺序，分为大端（Big Endian）和小端（Little Endian）两种，区别在于字节的高低位存储顺序不同。

语法

buffer.readIntLE(offset, byteLength[, noAssert])

参数

• offset：整数类型，表示从 Buffer 对象中读取的起始位置。该参数是必需的。如果 offset 不是整数类型，则会被自动转换为整数类型。
• byteLength：整数类型，表示从 Buffer 对象中读取的字节数。该参数是必需的。如果 byteLength 不是整数类型，则会被自动转换为整数类型。
• noAssert：布尔类型，可选参数。如果该参数为 true，则不会对 offset 和 byteLength 进行边界检查，默认为 false。

返回值

从 Buffer 对象中读取的整数值，返回一个数字类型的结果。

示例

下面是一个示例，用于解析一个长度为 6 字节的 Buffer 对象，以读取一个 24 位的整数值。

const buf = Buffer.from([0x03, 0xe8, 0x7f, 0xff, 0xff, 0xff]);

const intValue = buf.readIntLE(0, 3); // 从第 0 个字节开始，读取 3 个字节，即 24 位

console.log(intValue); // 输出：2147483647

在上面的示例中，我们首先定义了一个长度为 6 字节的 Buffer 对象 buf，然后使用 buf.readIntLE() 方法从 buf 对象中读取一个长度为 24 位的整数值，并将结果存储在 intValue 变量中。

注意事项

• Buffer.readIntLE() 方法用于读取小端字节序的整数值。如果要读取大端字节序的整数值，可以使用 Buffer.readIntBE() 方法。
• 读取的字节数不能超过 Buffer 对象的长度，否则会导致范围错误（RangeError）。
• 在读取整数值时，建议使用明确的字节数，避免出现字节序错误（Endianness Error）。
• 当需要读取多个整数值时，可以使用 offset 参数来指定读取的起始位置，byteLength 参数指定每个整数值的字节数。

参考链接

• Node.js Buffer 官方文档
• 字节序（Endianness）