JavaScript DataView getInt32() 方法

JavaScript DataView getInt32() 方法用于从指定的字节偏移量检索 4 字节数据值并将其解码为 32 位 有符号整数。可以从数据视图边界内的任意偏移量获取多个字节值。

如果 byteOffset 参数的值超出此数据视图的边界，则会抛出 'RangeError' 异常。

语法

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

getInt32(byteOffset, littleEndian)

参数

此方法接受两个名为"byteOffset"和"littleEndian"的参数，如下所述 -

• byteOffset - DataView 中读取位置数据。
• littleEndian − 指示数据是以小端格式还是大端格式存储。

返回值

此方法返回一个从 -2147483648 到 2147483647 的整数(含)。

示例 1

以下示例演示了 JavaScript DataView getInt32() 方法的用法。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(32);
   const data_view = new DataView(buffer);
   const value = 2147483647;
   const byteOffset = 0;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //存储值
   data_view.setInt32(byteOffset, value);
   document.write("<br>The store value: ", data_view.getInt32(byteOffset));
   </script>
</body>
</html>

输出

上述程序生成的存储值为 -

Value: 2147483647
The byte offset: 0
The store value: 2147483647

示例 2

如果未将 byteOffset 参数值传递给此方法，它将自动返回此数据视图中 byteOffset 0 处存储的值。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(32);
   const data_view = new DataView(buffer);
   const value = 2443;
   const byteOffset = 0;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //存储值
   data_view.setInt32(byteOffset, value);
   document.write("<br>The data_view.getInt32() method returns: ", data_view.getInt32());
</script>
</body>
</html>

输出

执行上述程序后，它将返回存储的值"2443"。

Value: 2443
The byte offset: 0
The data_view.getInt32() method returns: 2443

示例 3

如果 byteOffset 参数的值超出数据视图的边界，则会抛出 'RangeError' 异常。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(32);
   const data_view = new DataView(buffer);
   const value = 2443;
   const byteOffset = 0;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //存储值
   data_view.setInt32(byteOffset, value);
   try {
      document.write(data_view.getInt32(-1));
   } catch (error) {
      document.write("<br>", error);
   }
</script>
</body>
</html>

输出

上述程序执行后，将抛出"RangeError"异常，如下所示:

Value: 2443
The byte offset: 0
RangeError: Offset is outside the bounds of the DataView