Node.js - Buffer.writeBigInt64LE（） 方法

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

语法

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

 buf.writeBigInt64LE(value[, offset])

参数

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

• value − （必需） 要写入缓冲区的有符号 64 位整数。
• offset - 此处的偏移量表示开始写入的位置。偏移量必须大于或等于 0 且小于或等于 buffer.length-8。默认值为 0。

返回值

buf.writeBigInt64LE（） 方法写入 64 位有符号整数值，并返回偏移量加上写入的字节数。

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

const buffer = Buffer.alloc(10);
buffer.writeBigInt64LE(0x0108890060708n, 0);
console.log(buffer);

输出

我们使用此方法使用的偏移量为 0。执行时，第 0 个位置的 64 位有符号整数将被写入创建的缓冲区。为上述创建的缓冲区长度为 10。因此，我们只能使用值从 0 到 2 的偏移量。如果任何值 >2，它将给出错误ERR_OUT_OF_RANGE。

例

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

const buffer = Buffer.alloc(10);
buffer.writeBigInt64LE(0x0108890060708n, 3);
console.log(buffer);

输出

例

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

const buffer = Buffer.allocUnsafe(10);
buffer.writeBigInt64LE(0x010060708n);
console.log(buffer);

输出

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