JavaScript DataView setInt32() 方法



JavaScript DataView 的setInt32() 方法用於將數值儲存為32 位有符號整數,儲存在從指定位元組偏移量開始的 4 個位元組中。可以在此 DataView 的邊界內的任何偏移量儲存多個位元組。

如果指定的數值不在-2147483648 到 2147483647的範圍內,則不會將該值儲存在此 DataView 中,如果 byteOffset 引數的值超出此 DataView 的邊界,則會丟擲'RangeError'異常。

語法

以下是 JavaScript DataView setInt32() 方法的語法:

setInt32(byteOffset, value, littleEndian)

引數

此方法接受三個名為 'byteOffset'、'value' 和 'littleEndian' 的引數,如下所述:

  • byteOffset - DataView 中儲存位元組的位置。
  • value - 需要儲存的有符號 32 位整數。
  • littleEndian - 指示資料值是儲存為小端格式還是大端格式。

返回值

此方法返回'undefined'

示例 1

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

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 200;
   const byteOffset = 0;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //using the setInt32() method
   document.write("<br>The data_view.setInt32() method returns: ",  data_view.setInt32(byteOffset, value));
</script>
</body>
</html>

輸出

以上程式返回 'undefined' -

Value: 200
The byte offset: 0
The data_view.setInt32() method returns: undefined

示例 2

如果資料值超出-21474836482147483647的範圍,則setInt8()方法將不會儲存指定的值,因為它超出了 8 位有符號整數的範圍。

<html>
<head>
<title>JavaScript DataView setInt32() Method</title>
</head>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 21474836478;
   const byteOffset = 1;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   //using the setInt32() method
   data_view.setInt32(byteOffset, value);
   document.write("<br>The store value: ", data_view.getInt32(1));
</script>
</body>
</html>

輸出

執行程式後,由於資料值超出可接受值的範圍,因此不會儲存資料值 -

Value: 21474836478
The byte offset: 1
The store value: -2

示例 3

如果 byteOffset 引數的值超出此資料檢視的邊界,則會丟擲'RangeError'異常。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 243;
   const byteOffset = -1;
   document.write("Value: ", value);
   document.write("<br>The byte offset: ", byteOffset);
   try {
      //using the setInt32() method
      data_view.setInt32(byteOffset, value);
   } catch (error) {
      document.write("<br>", error);
   }
</script>
</body>
</html>

輸出

執行以上程式後,將丟擲 'RangeError' 異常。

Value: 243
The byte offset: -1
RangeError: Offset is outside the bounds of the DataView
廣告