Node.js - Buffer.writeIntLE（）方法

NodeJS Buffer.writeIntLE（） 方法有助于在给定偏移量处以小端形式将字节长度的值写入缓冲区。

语法

以下是Node.JS Buffer.writeIntLE（）方法的语法 -


 buf.writeIntLE(value, offset, bytelength)

参数

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

value − （必填）要写入缓冲区的数字。
offset − （必需）指示开始写入的位置的偏移量。偏移量大于或等于 0，也小于或等于 buffer.length-bytelength。默认值为 0
byteLength − （必需）您要写入的字节数。byteLength 必须介于 0 到 6 之间。

返回值

buffer.writeIntLE（） 方法写入给定值并返回偏移量加上写入的字节数。

例

为了创建一个缓冲区，我们将使用 NodeJS Buffer.alloc（）方法 -


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

输出

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

例

在此示例中，将使用字节长度> 6。它应该抛出一个错误，如下所示。


const buffer = Buffer.alloc(10);
buffer.writeIntLE(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.writeIntLE (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.writeIntLE(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 "offset" is out of range. It must be >= 0 and <= 5. Received 6
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 <= 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_Int24LE (internal/buffer.js:707:3)
at Buffer.writeIntLE (internal/buffer.js:846: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'
}

打印本页

Node.js - Buffer.writeIntLE（） 方法

语法

参数

Node.js - Buffer.writeIntLE（）方法