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 − 它指示数据是以 little-endian 还是 big-endian 格式存储。

返回值

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

示例 1

以下是 JavaScript DataView setBigUint64（）方法的基本示例。


<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 in an unsigned 64-bit integer
	 	const value = 2n ** 64n - 1n;
	 	document.write("The byte offset: ", byteOffset);
	 	document.write("<br>Value: ", value);
	 	//using the setBigUnit64() method
	 	data_view.setBigUint64(byteOffset, value);
	 	document.write("<br>The stored value: ", data_view.getBigUint64(byteOffset));
</script>
</body>
</html>

输出

上述程序将指定的 bigInt unsigned 值存储在当前 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;
	 	//find the highest possible BigInt value that fits in an unsigned 64-bit integer
	 	const value = 2n ** 64n - 1n;
	 	document.write("The byte offset: ", byteOffset);
	 	document.write("<br>Value: ", value);
	 	//using the setBigUnit64() method
	 	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;
	 	//find the highest possible BigInt value that fits in an unsigned 64-bit integer
	 	const value = 23456543212;
	 	document.write("The byte offset: ", byteOffset);
	 	document.write("<br>Value: ", value);
	 	try {
	 	 	 //using the setBigUnit64() method
	 	 	 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;
	 	//find the highest possible BigInt value that fits in an unsigned 64-bit integer
	 	const value = 23456543212;
	 	document.write("The byte offset: ", byteOffset);
	 	document.write("<br>Value: ", value);
	 	try {
	 	 	 //using the setBigUnit64() method
	 	 	 data_view.setBigUint64(byteOffset, value);	
	 	} catch (error) {
	 	 	 document.write("<br>", error);
	 	}
</script>
</body>
</html>

输出

上述程序将 'TypeError' 异常抛出为 −