JavaScript DataView setUint32() 方法



JavaScript DataView 的 setUint32() 方法將一個值儲存為 32 位 (1 位元組 = 8 位)無符號整數,儲存位置從此資料檢視的指定位元組偏移量開始的4 個位元組

如果位元組偏移量超出此 DataView 的範圍,則會丟擲'RangeError'異常。

語法

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

setUint32(byteOffset, value, littleEndian)

引數

此方法接受三個引數,分別名為“byteOffset”、“value”和“littleEndian”,如下所述:

  • byteOffset - DataView 中將儲存位元組的位置。
  • value - 需要儲存的 32 位無符號整數。
  • littleEndian (可選) - 指示資料是以小端序還是大端序儲存。

返回值

此方法返回 undefined,因為它只儲存位元組值。

示例 1

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

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 20;
   const byteOffset = 0;
   document.write("The data value: ", value);
   document.write("<br>The byteOffset: ", byteOffset);
   document.write("<br>The setUnit32() method returns: ", data_view.setUint32(byteOffset, value));
</script>
</body>
</html>

輸出

上述程式返回“undefined”。

The data value: 20
The byteOffset: 0
The setUnit32() method returns: undefined

示例 2

如果 byteOffset 引數值超出此 DataView 的範圍,它將丟擲'RangeError'異常。

<html>
<body>
<script>
   const buffer = new ArrayBuffer(16);
   const data_view = new DataView(buffer);
   const value = 24;
   const byteOffset = -1;
   document.write("The data value: ", value);
   document.write("<br>The byteOffset: ", byteOffset);
   try {
      data_view.setUint32(byteOffset, value);
   } catch (error) {
      document.write("<br>Error: " + error);
   }
</script>
</body>
</html>

輸出

執行上述程式後,將丟擲異常:

The data value: 24
The byteOffset: -1
Error: RangeError: Offset is outside the bounds of the DataView
廣告