JavaScript DataView setFloat64() 方法



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

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

如果 byteOffset 参数的值超出数据视图的范围,则会抛出'RangeError'异常。

语法

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

setFloat64(byteOffset, value, littleEndian)

参数

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

  • byteOffset - DataView 中将存储字节的位置。
  • value - 需要存储的 32 位浮点数。
  • littleEndian - 它指示数据是以小端还是大端格式存储的。

返回值

此方法返回'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中检索)从指定的字节1开始,在这个 DataView 中。

<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
广告