JavaScript DataView setFloat64() 方法



JavaScript DataView setFloat64() 方法用于存储 8 字节(其中 1 字节 = 8 位)的 64 位浮点数,从此 DataView 中的指定字节偏移量开始。可以在指定边界内的任何字节偏移量处存储多个字节值。

浮点数是带小数点的正整数或负整数。例如,5.5、0.25、-103.342 等。

如果 byteOffset 参数的值超出数据视图的边界,它将引发 'RangeError' 异常。

语法

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


 setFloat64(byteOffset, value, littleEndian)

参数

此方法接受名为 'byteOffset'、'value' 和 'littleEndian' 的三个参数,如下所述 -

  • byteOffset - DataView 中将存储字节的位置。
  • value − 需要存储的 32 位浮点数。
  • littleEndian − 它表示数据是以 little-endian 还是 big endian 格式存储。

返回值

此方法返回 'undefined'。

示例 1

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


<html>
<body>
<script>
	 	const buffer = new ArrayBuffer(16);
	 	const data_view = new DataView(buffer);
	 	const byteOffset = 0;
	 	const value = 433.45;
	 	document.write("The byte offset: ", byteOffset);
	 	document.write("<br>Value: ", value);
	 	//using setFloat64() method
	 	document.write("<br>The setFloat64() method: ", data_view.setFloat64(byteOffset, value));
</script>
</body>
</html>

输出

上面的程序返回 'undefined' -

The byte offset: 0
Value: 433.45
The setFloat64() method: undefined

示例 2

以下是 JavaScript DataView setFloat64() 方法的另一个示例。我们使用此方法存储 64 位浮点数(从中检索)Math.PI 在此 DataView 中的指定字节 1 开始。


<html>
<body>
<script>
	 	 const buffer = new ArrayBuffer(16);
	 	 const data_view = new DataView(buffer);
	 	 const byteOffset = 1;
	 	 const value = Math.PI;
	 	 document.write("The byte offset: ", byteOffset);
	 	 document.write("<br>Value: ", value);
	 	 //using setFloat64() method
	 	data_view.setFloat64(byteOffset);
	 	document.write("<br>The store value: ", data_view.getFloat64(byteOffset, value));
</script>
</body>
</html>

输出

执行完上述程序后,它会将指定的浮点数存储在 DataView 中,并将其显示为 -

The byte offset: 1
Value: 3.141592653589793
The store value: 3.143e-319

示例 3

如果 byteOffset 参数的值超出此数据视图的边界,它将引发 'RangeError' 异常。


<html>
<body>
<script>
	 	const buffer = new ArrayBuffer(16);
	 	const data_view = new DataView(buffer);
	 	const byteOffset = -1;
	 	const value = 16.34;
	 	document.write("The byte offset: ", byteOffset);
	 	document.write("<br>Value: ", value);
	 	try {
	 	 	 //using setFloat64() method
	 	 	 data_view.setFloat64(byteOffset);
	 	} catch (error) {
	 	 	 document.write("<br>", error);
	 	}
</script>
</body>
</html>

输出

一旦执行了上述程序,它将抛出一个 'RangeError' 异常,即 -

The byte offset: -1
Value: 16.34
RangeError: Offset is outside the bounds of the DataView