Node.js - Buffer.readInt16BE() 方法

NodeJS 的 `Buffer.readInt16BE()` 方法用于从缓冲区中以大端序读取指定偏移量处的有符号 16 位整数。从缓冲区读取的整数以二进制补码表示。

16 位有符号整数的取值范围为 -32768 到 32767。

**二进制补码**是二进制数的一种数学运算。要获得任何给定二进制数的二进制补码，步骤如下：

二进制数: 101011

• **步骤 1** - 首先找到二进制数 101011 的反码：要得到反码，需要将 1 变成 0，将 0 变成 1。所以上述二进制数的反码是：010100。

• **步骤 2** - 现在，对步骤 1 中的反码加 1。

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

语法

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

buf.readInt16BE(offset)

参数

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

返回值

此方法返回当前缓冲区中给定偏移量处内容的 16 位有符号整数值。

示例

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

const buffer = Buffer.from([0,15,10,12]);
console.log("buffer stored in memory as", buffer);  
console.log("Reading 16 bit signed integer at offset 0:", buffer.readInt16BE(0));

输出

我们在此方法中使用的偏移量为 0。将返回第 0 位的 16 位有符号整数。上面创建的缓冲区长度为 4。因此，我们只能使用值为 0、1 和 2 的偏移量。如果任何值 > 2，则会给出错误 **ERR_OUT_OF_RANGE**。

buffer stored in memory as <Buffer 00 0f 0a 0c>
Reading 16 bit signed integer at offset 0: 15

示例

让我们创建一个 16 位缓冲区，并查看使用 Node.JS `Buffer.readInt16BE()` 方法返回的值。

const buffer = Buffer.from([0, 1, 2, 3, 4, 5, 6, 7,8, 9, 10, 11,12, 13, 14, 15]);
console.log("Length of buffer is ", buffer.length);  
console.log("Reading at big integer at offset 2:", buffer.readInt16BE(2));

输出

Length of buffer is 16
Reading at big integer at offset 2: 515

示例

此示例将检查如果偏移量大于 `buffer.length - 2` 时出现的错误。让我们创建一个长度为 8 的缓冲区，这样可以将偏移量设置为 0 到 6。在下面的示例中，我们使用偏移量 7，因此它将抛出错误，如输出所示。

const buffer = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
console.log("buffer length is ", buffer.length);  
console.log("Reading at big integer at offset 7:", buffer.readInt16BE(7));

输出

buffer length is 8
internal/buffer.js:58
   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:58:9)
   at Buffer.readInt16BE (internal/buffer.js:402:5)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:3:59)
   at Module._compile (internal/modules/cjs/loader.js:816:30)
   at Object.Module._extensions..js (internal/modules/cjs/loader.js:827:10)
   at Module.load (internal/modules/cjs/loader.js:685:32)
   at Function.Module._load (internal/modules/cjs/loader.js:620:12)
   at Function.Module.runMain (internal/modules/cjs/loader.js:877:12)
   at internal/main/run_main_module.js:21:11