JavaScript DataView getBigUnit64（）方法

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

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

语法

以下是 JavaScript DataView getBigUnit64（）方法的语法 -


 getBigUnit64(byteOffset, littleEndian)

参数

此方法接受两个名为 'byteOffset' 和 'littleEndian' 的参数，如下所述 -

byteOffset - DataView 中要从中读取数据的位置。
littleEndian − 它指示数据是以 little-endian 还是 big-endian 格式存储。

返回值

此方法返回 0 到 2⁶⁴ - 1 范围（包括 0 到 2⁶⁴ - 1）的 BigInt。

示例 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

以下是 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;
	 	//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

打印本页

JavaScript DataView getBigUnit64（） 方法

语法

参数

返回值

示例 1

示例 2

示例 3

JavaScript DataView getBigUnit64（）方法