Node.js - Buffer.readBigUInt64LE() 方法

---

---

Node.JS Buffer.readBigUInt64LE() 方法用於從當前緩衝區物件中給定偏移量讀取一個無符號小端序 64 位整數。

在計算機程式設計中，無符號整數指正整數，而有符號整數指正數和負數。對於 64 位無符號整數，最小值為 0，最大值為 2⁶⁴-1。

語法

以下是 Node.JS Buffer.readBigUInt64LE() 方法 的語法：

buf.readBigUInt64LE([offset])

引數

此方法接受一個引數，如下所述。

• offset − 偏移量指示從緩衝區開始讀取的位置。偏移量範圍在 0 到 buffer.length-8 之間。預設值為 0。

返回值

此方法返回當前緩衝區中給定偏移量處內容的 64 位無符號整數。

您也可以使用可用的別名函式：buf.readBigUint64LE(offset)。此處函式名 (I) 為小寫。

示例

要建立緩衝區，我們將使用 NodeJS 的 Buffer.from() 方法：

const buffer = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
console.log("buffer stored in memory as", buffer);  
console.log("Reading at big unsigned integer at offset 0:", buffer.readBigUInt64LE(0));

輸出

我們在此方法中使用的偏移量為 0。將返回第 0 位的 64 位無符號整數。上面建立的緩衝區長度為 8。因此我們只能使用值為 0 的偏移量。任何大於 0 的值都會導致 ERR_OUT_OF_RANGE 錯誤。

buffer stored in memory as <Buffer 00 00 00 00 ff ff ff ff>
Reading at big unsigned integer at offset 0: 18446744069414584320n

示例

讓我們建立一個 16 位的緩衝區，並檢視使用 Node.JS Buffer.readBigUInt64LE() 方法 返回的值。

const buffer = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff,
0xff, 0xff, 0xff, 0xff,0xff, 0xff, 0xff, 0xff]);
console.log("Length of buffer is ", buffer.length);  
console.log("Reading at big integer at offset 2:", buffer.readBigUInt64LE(2));

輸出

在上面的示例中，建立的緩衝區長度為 16。因此，對於偏移量，我們可以使用 0 到 8 的值。

Length of buffer is  16
Reading at big integer at offset 2: 18446744073709486080n

示例

此示例將檢查如果偏移量大於 buffer.length -8 時出現的錯誤。讓我們建立一個長度為 8 的緩衝區，並將其偏移量設定為 0。

const buffer = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
console.log("buffer length is ", buffer.length);  
console.log("Reading at big integer at offset 1:", buffer.readBigUInt64LE(1));

輸出

由於我們在上面的程式中使用了大於 0 的偏移量，因此會丟擲如下所示的錯誤：

buffer length is  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 <= 0. Received 1
   at boundsError (internal/buffer.js:83:9)
PS C:\nodejsProject> node src/testbuffer.js
buffer length is  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 <= 0. Received 1
   at boundsError (internal/buffer.js:83:9)
   at Buffer.readBigUInt64LE (internal/buffer.js:94:5)
   at Object.<anonymous> (C:\nodejsProject\src\testbuffer.js:3:59)
   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.readBigUint64LE() 方法。

const buffer = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
console.log("buffer length is ", buffer.length);  
console.log("Reading at big integer at offset 0:", buffer.readBigUint64LE(0));

輸出

我們使用偏移量 0 來獲取無符號大整數。執行上述程式後，將生成以下輸出：

buffer length is 8
Reading at big integer at offset 0: 18446744069414584320n