JavaScript DataView getBigUnit64() 方法

JavaScript DataView 的 getBigUint64() 方法用于从此 DataView 的指定字节偏移量开始检索 8 字节数据段。之后，该方法将它们解码为 64 位无符号 整数。您可以从 DataView 边界内的任意偏移量检索多个字节。

如果您尝试从超出 DataView 有效边界的位置读取数据，此方法将抛出 'RangeError' 异常。

语法

以下是 JavaScript DataView getBigUnit64() 方法的语法 -

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;
   //找到适合大无符号整数的最高可能的 BigInt 值
   const value = 2n ** (64n - 1n) - 1n;
   document.write("The byte offset: ", byteOffset);
   document.write("<br>Value: ", value);
   //使用 setBigUnit64() 方法存储值
   data_view.setBigUint64(byteOffset, value);
   //使用 getBigUnit64() 方法
   document.write("<br>The stored value:", data_view.getBigUint64(byteOffset));
</script>
</body>
</html>

输出

上述程序返回存储的值。

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

示例 2

以下是 setBigUnit64() 方法的另一个示例。我们使用此方法从指定的字节偏移量 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;
   //找到可能的最大 BigInt 值
   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 {
      //使用 getBigUnit64() 方法
     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