JavaScript DataView setUint32() 方法

JavaScript DataView 的 setUint32() 方法将一个值存储为 32 位 (1 字节 = 8 位)无符号整数，存储位置从此数据视图的指定字节偏移量开始的4 个字节。

如果字节偏移量超出此 DataView 的范围，则会抛出'RangeError'异常。

语法

以下是 JavaScript DataView setUint32() 方法的语法：

setUint32(byteOffset, value, littleEndian)

参数

此方法接受三个参数，分别名为“byteOffset”、“value”和“littleEndian”，如下所述：

byteOffset - DataView 中将存储字节的位置。
value - 需要存储的 32 位无符号整数。
littleEndian (可选) - 指示数据是以小端序还是大端序存储。

返回值

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

示例 1

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

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 20;
   const byteOffset = 0;
   document.write("The data value: ", value);
   document.write("<br>The byteOffset: ", byteOffset);
   document.write("<br>The setUnit32() method returns: ", data_view.setUint32(byteOffset, value));
</script>
</body>
</html>

输出

上述程序返回“undefined”。

The data value: 20
The byteOffset: 0
The setUnit32() method returns: undefined

示例 2

如果 byteOffset 参数值超出此 DataView 的范围，它将抛出'RangeError'异常。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 24;
   const byteOffset = -1;
   document.write("The data value: ", value);
   document.write("<br>The byteOffset: ", byteOffset);
   try {
      data_view.setUint32(byteOffset, value);
   } catch (error) {
      document.write("<br>Error: " + error);
   }
</script>
</body>
</html>

输出

执行上述程序后，将抛出异常：

The data value: 24
The byteOffset: -1
Error: RangeError: Offset is outside the bounds of the DataView

打印页面