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 08 07 06 90 88 10 00 00 00 00>

示例

在本例中，我們將使用一個大於 buffer.length - 8 的偏移量。它應該會丟擲如下所示的錯誤。

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

輸出

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 <= 2. Received 3
   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 <= 2. Received 3
   at boundsError (internal/buffer.js:83:9)
   at checkBounds (internal/buffer.js:52:5)
   at checkInt (internal/buffer.js:71:3)
   at writeBigU_Int64LE (internal/buffer.js:576:3)
   at Buffer.writeBigUInt64LE (internal/buffer.js:598:10)
   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'
   }

示例

為了建立一個緩衝區，我們將使用 Buffer.allocUnsafe() 方法：

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

輸出

未使用偏移量，預設情況下將取值為 0。因此，上面的輸出如下所示：

<Buffer 08 07 06 10 00 00 00 00 00 00>