Node.js Buffer.writeInt32LE() 方法

Node.js 提供了 Buffer 类，用于处理二进制数据。

Buffer 类的 writeInt32LE() 方法可以将 32 位的整数以指定的格式写入 Buffer 对象。

语法

Buffer.writeInt32LE(value, offset[, noAssert])

• value：要写入的 32 位整数值。
• offset：指定写入时的偏移量，即开始写入的索引位置。
• noAssert：可选参数，如果值为 true，则不会进行写入范围的检查。

返回值

返回值为 undefined。

示例

下面的示例演示了如何使用 Buffer.writeInt32LE() 方法将整数写入 Buffer 中：

const buffer = Buffer.alloc(4);

buffer.writeInt32LE(123456, 0);

console.log(buffer); // 输出：Buffer 40 e2 01 00

在上面的示例中，我们创建了一个长度为 4 的 Buffer 对象，并使用 writeInt32LE() 方法将整数 123456 写入 Buffer 中。

由于使用的是 little-endian 格式，在内存中，最低位字节为 40，其余字节为 e2 01 00。因此，console.log() 输出的结果为 Buffer 40 e2 01 00。

如果要将多个整数写入同一个 Buffer 对象，可以通过传递不同的 offset 参数实现：

const buffer = Buffer.alloc(8);

buffer.writeInt32LE(123456, 0);
buffer.writeInt32LE(-789012, 4);

console.log(buffer); // 输出：Buffer 40 e2 01 00 94 2a f7 ff

在上面的示例中，我们通过传递 0 和 4 作为 offset 参数，将两个整数写入同一个长度为 8 的 Buffer 对象中。

需要注意的是，如果不传递 noAssert 参数，writeInt32LE() 方法会检查写入范围是否越界。如果越界，将抛出 RangeError 异常：

const buffer = Buffer.alloc(2);

buffer.writeInt32LE(123456, 0); // 抛出 RangeError 异常

因为长度为 2 的 Buffer 对象无法容纳一个 32 位整数。如果要写入多字节的值，应该确保目标 Buffer 对象的长度能够容纳所有的字节。