Node.js - Buffer.writeInt32LE() 方法

NodeJS 的 Buffer.writeInt32LE() 方法用于以小端字节序的形式将一个带符号的 32 位整数写入缓冲区中的给定偏移量。写入缓冲区的整数表示为二进制补码带符号值。

32 位带符号整数的取值范围是 −2147483648 到 2147483647。

语法

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

buf.writeInt32LE(value[, offset])

参数

此方法接受两个参数，如下所述。

• **value** − （必需）写入缓冲区的带符号 32 位整数。

• **offset** − 指示开始读取位置的偏移量。偏移量大于或等于 0，并且小于或等于 buffer.length-4。默认值为 0。

返回值

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

示例

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

const buffer = Buffer.alloc(10);
buffer.writeInt32LE(0x0910, 0);
console.log(buffer);

输出

我们使用的偏移量为 0。执行时，从第 0 位开始的值将被写入创建的缓冲区。上面创建的缓冲区长度为 10。因此，我们只能使用偏移量值为 0 到 6。任何大于 6 的值都将引发 **ERR_OUT_OF_RANGE** 错误。

<Buffer 10 09 00 00 00 00 00 00 00 00>

示例

在此示例中，我们将使用一个大于 buffer.length - 4 的偏移量。它应该会抛出如下所示的错误。

const buffer = Buffer.alloc(10);
buffer.writeInt32LE(0x0910, 7);
console.log(buffer);

输出

internal/buffer.js:83
   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 <= 6. Received 7
   at boundsError (internal/buffer.js:83:9)
   at checkBounds (internal/buffer.js:52:5)
PS C:\nodejsProject> node src/testbuffer.js
internal/buffer.js:83
   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 <= 6. Received 7
   at boundsError (internal/buffer.js:83:9)
   at checkBounds (internal/buffer.js:52:5)
   at checkInt (internal/buffer.js:71:3)
   at writeU_Int32LE (internal/buffer.js:689:3)
   at Buffer.writeInt32LE (internal/buffer.js:858:10)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:2:8)
   at Module._compile (internal/modules/cjs/loader.js:1063:30)
   at Object.Module._extensions..js (internal/modules/cjs/loader.js:1092:10)
   at Module.load (internal/modules/cjs/loader.js:928:32)
   at Function.Module._load (internal/modules/cjs/loader.js:769:14) {
      code: 'ERR_OUT_OF_RANGE'
   }

示例

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

const buffer = Buffer.allocUnsafe(10);
buffer.writeInt32LE(0x0910);
console.log(buffer);

输出

未使用偏移量，默认情况下将取为 0。因此，上面的输出如下所示：

<Buffer 10 09 00 00 01 00 00 00 00 00>