Node.js Buffer.writeIntLE() 方法

Buffer.writeIntLE() 方法将一个 32 位整数值以 小端字节序 写入缓冲区中指定的偏移位置。小端字节序指的是在多字节值的字节表示中，较低位字节保存在内存地址中的较高位置，较高位字节保存在内存地址中的较低位置。该方法返回已写入的字节数。

语法

buf.writeIntLE(value, offset, byteLength)

• value: 要写入的 32 位整数值。
• offset: 整数值写入的起始位置。
• byteLength: 写入的字节数，可选，默认值为 4。

返回值

返回已写入的字节数。

示例

const buf = Buffer.alloc(4); // 生成一个长度为 4 字节的缓冲区

console.log(buf.writeIntLE(0x3a3b3c3d, 0)); // 输出 4
console.log(buf); // 输出 <Buffer 3d 3c 3b 3a>

上面的示例中，我们生成了一个长度为 4 字节的缓冲区，然后使用 buf.writeIntLE() 方法将整数值 0x3a3b3c3d 写入到偏移位置 0 处。由于我们采用小端字节序，所以缓冲区中的字节表示为 3d 3c 3b 3a，最后返回已写入的字节数，即 4。

注意事项

• 参数 value 应该是一个 32 位整数值，否则该方法将会抛出一个 RangeError 错误。
• 参数 offset 应该小于缓冲区的长度，否则该方法将会抛出一个 RangeError 错误。
• 如果参数 byteLength + offset 大于缓冲区的长度，则触发 RangeError 错误。
• 如果 byteLength 参数没有指定，则默认为 4。如果指定的 byteLength 小于 4，则将先填充缓冲区，然后从第 1 字节开始写入。如果指定的 byteLength 大于 4，则仅仅会写入 value 的低 32 位（后 4 个字节）。
• 该方法不会对已有的缓冲区内容进行截断的操作，即如果要写入的值的占用的字节数大于 byteLength，将不会影响缓冲区中原有字节的值。