JavaScript DataView getInt8() 方法

JavaScript DataView getInt8() 方法读取该 DataView 指定字节偏移量的 1 字节数据，并将其解码为 8 位有符号整数。如果您未为此方法指定 byteOffset 参数值，则它始终返回 0。

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

语法

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

getInt8(byteOffset)

参数

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

• byteOffset - DataView 中读取数据的位置。

返回值

此方法返回一个有符号整数，范围在 -128 到 127 之间(含)。

示例 1

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

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 127;
   const byteOffset = 0;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //存储数据
   data_view.setInt8(byteOffset, value);
   //使用 getInt8() 方法
   document.write("<br>The stored value:", data_view.getInt8(byteOffset));
</script>
</body>
</html>

输出

上述程序返回存储数据值，如下所示:

Value: 127
The byte offset: 0
The stored value:127

示例 2

如果我们不将 byteOffset 参数传递给此方法，它将返回 0。

以下是 JavaScript DataView getInt8() 方法的另一个示例。我们使用此方法在指定的 byteOffset 1 处读取 1 字节数据值 40。由于我们没有将 byteOffset 参数传递给此方法，因此它将返回 0。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(8);
   const data_view = new DataView(buffer);
   const value = 40;
   const byteOffset = 1;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //存储数据
   data_view.setInt8(byteOffset, value);
   //使用 getInt8() 方法
   document.write("<br>The data_view.getInt8() returns: ", data_view.getInt8());
</script>
</body>
</html>

输出

执行上述程序后，将返回 0。

Value: 40
The byte offset: 1
The data_view.getInt8() returns: 0

示例 3

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

<html>
<body>
<script>
   const buffer = new ArrayBuffer(8);
   const data_view = new DataView(buffer);
   const value = 121;
   const byteOffset = 2;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //存储数据
   data_view.setInt8(byteOffset, value);
   try {
      //使用 getInt8() 方法
      document.write("<br>The data_view.getInt8() returns: ", data_view.getInt8(-1));
   } catch (error) {
      document.write("<br>", error);
   }
</script>
</body>
</html>

输出

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

Value: 121
The byte offset: 2
RangeError: Offset is outside the bounds of the DataView