JavaScript DataView setInt16() 方法

JavaScript DataView 的setInt16() 方法將數值儲存為16 位有符號整數，儲存在從 DataView 指定位元組偏移量開始的 2 個位元組中。多個位元組可以儲存在邊界內的任何偏移量。

如果數值不在-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);
   //using the setInt16() method
   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);
   //using the setInt16() method
   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 {
      //using the setInt16() method
      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

列印頁面