Node.js Buffer.readUInt16BE() 方法

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。它使用事件驱动、非阻塞 I/O 模型，使其轻量又高效。Node.js 中的 Buffer 类被用于处理与网络流或文件等源的二进制数据。

Buffer.readUInt16BE() 方法是 Node.js 中 Buffer 类的一个方法，它从一个 Buffer 对象中读取 16 位无符号整数值。该方法返回的值是一个 unsigned short 型（两字节）的整数。默认情况下，它将字节序解释为 big-endian（即高位字节在前，低位字节在后）。

语法

readUInt16BE() 方法的语法如下：

buf.readUInt16BE(offset[, noAssert])

其中，offset 表示要读取值的起始位置，noAssert 是一个布尔值表示是否省略边界检查。

返回值

readUInt16BE() 方法返回 Buffer 中指定位置的 16 位无符号整数值。

示例

以 0xfeed 为例，它的二进制表示为 1111111011101101。下面是使用 readUInt16BE() 方法读取这个值的示例代码：

const buf = Buffer.from([0xfe, 0xed]); // 0111111011101101
console.log(buf.readUInt16BE(0).toString(16)); // 输出 "feed"

上面的例子中，我们首先创建了一个包含两个字节的 Buffer 对象。该对象的二进制表示分别是 11111110 和 11101101，它们以高位字节在前、低位字节在后的方式存储在内存中。然后，我们通过调用 buf.readUInt16BE(0) 方法读取了这个 Buffer 对象的起始位置的 16 位无符号整数值。最后，我们将返回的整数值转换成 16 进制字符串输出。

注意事项

• 要确保 offset 参数在 0 和 Buffer 对象长度之间。
• 如果省略 noAssert 参数或将其设置为 false，则 readUInt16BE() 方法会在读取值时执行边界检查。如果 offset 参数超过了 Buffer 对象的长度，则会抛出 RangeError 错误。
• 如果将 noAssert 参数设为 true，则 readUInt16BE() 方法将不会执行边界检查，如果 offset 参数超过了 Buffer 对象的长度，则不会抛出错误，但返回的值是无意义的。
• 如果读取的值不是一个有效的 16 位无符号整数值，则会抛出 RangeError 错误。