JavaScript DataView setFloat64() 方法

JavaScript DataView 的 setFloat64() 方法用于将一个 64 位浮点数存储在此 DataView 中指定字节偏移量开始的 8 个字节(1 字节 = 8 位)中。可以在指定范围内的任意字节偏移量存储多个字节值。

浮点数是带有小数点的正整数或负整数。例如，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 DataViewsetFloat64()方法的另一个示例。我们使用此方法将 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);
    //使用 setFloat64() 方法
   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 {
      //使用 setFloat64() 方法
      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