JavaScript DataView setInt16() 方法

JavaScript DataView setInt16() 方法将数字值作为 16 位 有符号整数存储在 2 个字节中，从此 DataView 的指定字节偏移量开始。多个字节可以存储在边界内的任意偏移量处。

如果数值不在 -32768 到 32767 的范围内，则不会将该值存储在此 DataView 中;如果 byteOffset 参数值超出此 DataView 的边界，则会抛出 'RangeError' 异常。

语法

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

setInt16(byteOffset, value, littleEndian)

参数

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

• byteOffset − DataView 中字节的存储位置。
• value − 需要存储的有符号 16 位整数。
• littleEndian − 指示数据值是以小端格式还是大端格式存储。

返回值

此方法返回'undefined'，因为它仅存储一个字节值。

示例 1

以下程序演示了 JavaScript DataView setInt16() 方法的用法。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 255;
   const byteOffset = 1;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //使用 setInt16() 方法
   document.write("<br>The data_view.setInt16() method returns: ",  data_view.setInt16(byteOffset, value));
</script>
</body>
</html>

输出

上述程序返回"undefined" -

Value: 255
The byte offset: 1
The data_view.setInt16() method returns: undefined

示例 2

如果数据值超出了 -32768 到 32767 的范围，setInt16() 方法将不会存储指定的值，因为它超出了 8 位有符号整数的范围。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 327678;
   const byteOffset = 0;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //使用 setInt16() 方法
   data_view.setInt16(byteOffset, value);
   document.write("<br>The store value: ", data_view.getInt32(1));
</script>
</body>
</html>

输出

执行程序后，数据值将不会被存储，因为它超出了可接受值的范围 -

Value: 327678
The byte offset: 0
The store value: -33554432

示例 3

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

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 300;
   const byteOffset = -2;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   try {
      //使用 setInt16() 方法
      data_view.setInt16(byteOffset, value);
   } catch (error) {
      document.write("<br>", error);
   }
</script>
</body>
</html>

输出

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

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