Node.js - Buffer.writeBigUInt64LE（） 方法

NodeJS Buffer.writeBigInt64LE（） 方法有助于在给定偏移量处以小端形式将无符号 64 位整数写入缓冲区。

在计算机编程中，无符号整数是指正整数，有符号整数是指正值和负值。

对于 64 位，无符号整数的最小值为 0，最大值为 $2^{64}$-1。

语法

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

 buf.writeBigUInt64LE(value[, offset])

参数

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

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

返回值

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

您还可以使用可用的别名函数：buf.writeBigUint64LE（value[，offset]）。这里的函数 （I） 是小写的。

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

const buffer = Buffer.alloc(10);
buffer.writeBigUInt64LE(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.writeBigUInt64LE(0x0108890060708n, 3);
console.log(buffer);

输出

例

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

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

输出

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