JavaScript DataView getBigUint64() 方法

JavaScript DataView 的getBigUint64()方法用於從該 DataView 的指定位元組偏移量開始檢索 8 位元組的資料段。隨後，它將它們解碼為64 位無符號整數。您可以從 DataView 範圍內的任何偏移量檢索多個位元組。

如果您嘗試讀取超出 DataView 有效範圍的位置的資料，此方法將丟擲'RangeError'異常。

語法

以下是 JavaScript DataView getBigUint64()方法的語法：

getBigUnit64(byteOffset, littleEndian)

引數

此方法接受兩個名為“byteOffset”和“littleEndian”的引數，如下所述：

byteOffset - 從 DataView 中讀取資料的起始位置。
littleEndian - 指示資料是以小端序還是大端序格式儲存。

返回值

此方法返回一個 BigInt，其範圍從0到2⁶⁴ - 1（包括）。

示例 1

以下程式演示了 JavaScript DataView getBigUint64()方法的使用。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const byteOffset = 0;
   //find the highest possible BigInt value that fits for the big unsigned integer 
   const value = 2n ** (64n - 1n) - 1n;
   document.write("The byte offset: ", byteOffset);
   document.write("<br>Value: ", value);
   //using the setBigUnit64() method to store value
   data_view.setBigUint64(byteOffset, value);
   //using the getBigUnit64() method
   document.write("<br>The stored value: ", data_view.getBigUint64(byteOffset));
</script>
</body>
</html>

輸出

上述程式返回儲存的值。

The byte offset: 0
Value: 9223372036854775807
The stored value: 9223372036854775807

示例 2

以下是setBigUint64()方法的另一個示例。我們使用此方法從指定的位元組偏移量1檢索資料檢視的 8 位元組資料段。

<html>
<body>
<script>
   const { buffer } = new Uint8Array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
   const data_view = new DataView(buffer);
   const byteOffset = 1;
   document.write("The byte offset: ", byteOffset);
   document.write("<br>The data_view.getBigUnit64(1) method returns: ", data_view.getBigUint64(byteOffset));
</script>
</body>
</html>

輸出

執行上述程式後，它將返回一個 8 位元組的資料段，如下所示：

The byte offset: 1
The data_view.getBigUnit64(1) method returns: 72623859790382856

示例 3

如果 byteOffset 引數的值超出此資料檢視的範圍，則會丟擲'RangeError'異常。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const byteOffset = 1;
   //find the highest possible BigInt value 
   const value = 2n ** (64n - 1n) - 1n;
   document.write("The byte offset: ", byteOffset);
   document.write("<br>Value: ", value);
   //storing the value
   data_view.setBigInt64(byteOffset, value);
   try {
      //using the getBigUnit64() method
     document.write("<br>The store value: ", data_view.getBigUnit64(-1));
   } catch (error) {
     document.write("<br>", error);
   }
</script>
</body>
</html>

輸出

執行上述程式後，將丟擲以下異常：

The byte offset: 1
Value: 9223372036854775807
TypeError: data_view.getBigUnit64 is not a function

列印頁面