Node.js - Buffer.writeInt16LE() 方法



Buffer.writeInt16LE() 方法有助于在给定的偏移量处以小端形式向缓冲区写入有符号的 16 位整数。写入缓冲区的整数表示为 2 的补码有符号值。

使用 16 位有符号整数存储的值范围为 −32768 到 32767。

二的补码是对二进制数的数学运算。为了使任何给定的二进制数的两者完成,它将如下所示 -

二进制文件: 101011

  • 第 1 步 - 首先找到二进制数的补码:101011。要获得一个完整的,您需要将 1 设为 0,将 0 设为 1。所以上述二进制数的 1 补码是:010100。
  • 第 2 步 - 现在,对于第 1 步中的补码,将 1 添加到其中。

 I.e. 010100 + 1 = 010101. So 010101 is the two's complement of binary number 101011.

语法

以下是Node.JS Buffer.writeInt16LE()方法的语法 -


 buf.writeInt16LE(value[, offset])

参数

此方法接受两个参数。下面将对此进行解释。

  • value − (必需)要写入缓冲区的有符号 16 位整数。
  • offset - 指示开始读取的位置的偏移量。偏移量大于或等于 0,也小于或等于 buffer.length-2。默认值为 0。

返回值

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

为了创建一个缓冲区,我们将使用 NodeJS Buffer.alloc() 方法 -


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

输出

我们使用的偏移量是 0。在执行时,从第 0 个位置开始的值将被写入创建的缓冲区。为上述创建的缓冲区长度为 10。因此,我们只能使用值为 0 到 8 的偏移量。如果任何值 >8,它将给出错误 ERR_OUT_OF_RANGE

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

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


const buffer = Buffer.alloc(10);
buffer.writeInt16LE(0x0910, 9);
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 <= 8. Received 9
at boundsError (internal/buffer.js:83:9)
at checkBounds (internal/buffer.js:52:5)
at checkInt (internal/buffer.js:71:3)
at writeU_Int16LE (internal/buffer.js:719:3)
at Buffer.writeInt16LE (internal/buffer.js:862: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.writeInt16LE(0x0910);
console.log(buffer);

输出

偏移量不使用,默认情况下将取为 0。因此,上述的输出如下所示 -

<Buffer 00 00 11 45 01 00 00 00 00 00>