Node.js - Buffer.writeIntBE() 方法

NodeJS 的 Buffer.writeIntBE() 方法用于以大端字节序的形式将指定长度的数值写入缓冲区中给定偏移量的位置。

语法

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

buf.writeIntBE(value, offset, bytelength)

参数

此方法接受三个参数。具体说明如下。

• value − (必填) 要写入缓冲区的数字。

• offset − (必填) 指示写入起始位置的偏移量。偏移量必须大于或等于 0，并且小于或等于 buffer.length-bytelength。默认值为 0。

• byteLength − (必填) 要写入的字节数。byteLength 必须介于 0 到 6 之间。

返回值

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

示例

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

const buffer = Buffer.alloc(10);
buffer.writeIntBE(123, 0, 6);
console.log(buffer);

输出

我们使用的偏移量为 0，字节长度为 6。执行时，从第 0 位开始的值将写入创建的缓冲区。上面创建的缓冲区长度为 10。因此，我们只能使用 0 到 4 之间的偏移量值。如果任何值 >4，则会报错 ERR_OUT_OF_RANGE。

<Buffer 00 00 00 00 00 7b 00 00 00 00>

示例

在此示例中，我们将使用大于 6 的字节长度。它应该抛出如下所示的错误。

const buffer = Buffer.alloc(10);
buffer.writeIntBE(123, 0, 8);
console.log(buffer);

输出

internal/buffer.js:83
   throw new ERR_OUT_OF_RANGE(type || 'offset',
   ^
   
RangeError [ERR_OUT_OF_RANGE]: The value of "byteLength" is out of range. It must be >= 1 and <= 6. Received 8
   at boundsError (internal/buffer.js:83:9)
   at Buffer.writeIntBE (internal/buffer.js:854:3)
   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)
   at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:72:12)
   at internal/main/run_main_module.js:17:47 {
      code: 'ERR_OUT_OF_RANGE'
   }

示例

在此示例中，我们将使用大于 buffer.length − bytelength 的偏移量。

const buffer = Buffer.alloc(10);
buffer.writeIntBE(123, 8, 3);
console.log(buffer);

输出

偏移量必须在 0 到 7 之间。由于我们使用了 8，它将抛出如下所示的错误：

internal/buffer.js:83
   throw new ERR_OUT_OF_RANGE(type || 'offset',
   ^
   
RangeError [ERR_OUT_OF_RANGE]: The value of "byteLength" is out of range. It must be >= 1 and <= 6. Received 8
   at boundsError (internal/buffer.js:83:9)
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 <= 7. Received 8
   at boundsError (internal/buffer.js:83:9)
   at checkBounds (internal/buffer.js:52:5)
   at checkInt (internal/buffer.js:71:3)
   at writeU_Int24BE (internal/buffer.js:817:3)
   at Buffer.writeIntBE (internal/buffer.js:875:12)
   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'
   }