JavaScript DataView setBigUint64() 方法

JavaScript DataView 的 setBigUint64() 方法接受一个大整数，并将其作为 64 位无符号 整数存储在此 DataView 中从指定字节偏移量开始的 8 字节段中。

没有严格的对齐要求;您可以在 DataView 边界内的任意偏移量存储多个字节。

如果 byteOffset 参数的值超出此边界，则此方法会抛出 'RangeError' 异常;如果给定值不适合 bigInt 无符号整数，则抛出 'TypeError' 异常。

语法

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

setBigUint64(byteOffset, value, littleEndian)

参数

此方法接受三个参数，分别为"byteOffset"、"value"和"littleEndian"，如下所述−

• byteOffset − DataView 中字节的存储位置。
• value − 需要存储的 64 位无符号大整数。
• littleEndian − 指示数据是以小端还是大端格式存储。

返回值

此方法返回 'undefined'，因为它仅存储字节值。

示例 1

以下是 JavaScript DataView setBigUint64() 方法的基本示例。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const byteOffset = 0;
   //找到适合无符号 64 位整数的最高可能的 BigInt 值
   const value = 2n ** 64n - 1n;
   document.write("The byte offset: ", byteOffset);
   document.write("<br>Value: ", value);
   //使用 setBigUnit64() 方法
   data_view.setBigUint64(byteOffset, value);
   document.write("<br>The stored value:", data_view.getBigUint64(byteOffset));
</script>
</body>
</html>

输出

上述程序将指定的 bigInt 无符号值存储在当前 DataView 中，并将其显示为 -

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

示例 2

如果您尝试打印此方法的结果，它将返回 'undefined' 作为输出。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const byteOffset = 1;
   //找到适合无符号 64 位整数的最高可能的 BigInt 值
   const value = 2n ** 64n - 1n;
   document.write("The byte offset: ", byteOffset);
   document.write("<br>Value: ", value);
   //使用 setBigUnit64() 方法
   document.write("<br>The data_view.setBigUnit64() method returns: ",    data_view.setBigUint64(byteOffset, value));
</script>
</body>
</html>

输出

执行上述程序后，将返回"undefined"未定义的结果。

The byte offset: 1
Value: 18446744073709551615
The data_view.setBigUnit64() method returns: undefined

示例 3

如果 byteOffset 参数的值超出此数据视图的边界，则会抛出 'RangeError' 异常。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const byteOffset = 0;
   //找到适合无符号 64 位整数的最高可能的 BigInt 值
   const value = 23456543212;
   document.write("The byte offset: ", byteOffset);
   document.write("<br>Value: ", value);
   try {
      //使用 setBigUnit64() 方法
      data_view.setBigUint64(byteOffset, value); 
   } catch (error) {
      document.write("<br>", error);
   }
</script>
</body>
</html>

输出

上述程序执行后，将抛出"RangeError"异常。

The byte offset: 0
Value: 23456543212
TypeError: Cannot convert 23456543212 to a BigInt

示例 4

如果给定值不适合 bigInt 无符号整数，此方​​法将抛出 'TypeError' 异常。

<html>
<head>
<title>JavaScript DataView setBigUint64() Method</title>
</head>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const byteOffset = 0;
   //找到适合无符号 64 位整数的最高可能的 BigInt 值
   const value = 23456543212;
   document.write("The byte offset: ", byteOffset);
   document.write("<br>Value: ", value);
   try {
      //使用 setBigUnit64() 方法
      data_view.setBigUint64(byteOffset, value); 
   } catch (error) {
      document.write("<br>", error);
   }
</script>
</body>
</html>

输出

上述程序抛出"TypeError"异常，如下所示:

The byte offset: 0
Value: 23456543212
TypeError: Cannot convert 23456543212 to a BigInt