1. 首页
  2. JavaScript 菜鸟教程
  3. JavaScript DataView setInt8() 方法

JavaScript DataView setInt8() 方法

JavaScript DataView setInt8（） 方法用于在此 DataView 的指定 byteOffset 的开头的字节（1 字节 = 8 位）中存储一个 8 位有符号整数值。

如果 byteOffset 参数值超出此 DataView 的边界，则此方法将引发 'RangeError'。

语法

以下是 JavaScript DataView setInt8（） 方法的语法 -


 setInt8(byteOffset, value)

参数

此方法接受两个名为 'byteOffset' 和 'value' 的参数，如下所述 -

  • byteOffset - DataView 中将存储字节的位置。
  • value − 需要存储的有符号 8 位整数。

返回值

此方法返回 'undefined'。

示例 1

以下程序演示了 JavaScript DataView setInt8（） 方法的用法。


<html>
<body>
<script>
	 	const buffer = new ArrayBuffer(8);
	 	const data_view = new DataView(buffer);
	 	const byteOffset = 1;
	 	const value = 45;
	 	document.write("The byteOffset: ", byteOffset);
	 	document.write("<br>The data value: ", value);
	 	//using the setInt8() method
	 	document.write("<br>The setInt8() method returns: ", data_view.setInt8(byteOffset, value));
</script>
</body>
</html>

输出

上面的程序返回 'undefined' -

The byteOffset: 1
The data value: 45
The setInt8() method returns: undefined

示例 2

在下面的示例中，我们使用 setInt8（） 方法将 8 位有符号整数 43234 存储在此 DataView 中指定 byteOffset 0 处的字节中。


<html>
<body>
<script>
	 	const buffer = new ArrayBuffer(8);
	 	const data_view = new DataView(buffer);
	 	const byteOffset = 1;
	 	const value = 20;
	 	document.write("The byteOffset: ", byteOffset);
	 	document.write("<br>The data value: ", value);
	 	//using the setInt8() method
	 	document.write("<br>The setInt8() method returns: ", data_view.setInt8(byteOffset, value));
	 	document.write("<br>The stored value: ", data_view.getInt8(byteOffset));
</script>
</body>
</html>

输出

一旦执行了上述程序，它将存储给定值 20 的字节数 DataView -

The byteOffset: 1
The data value: 20
The setInt8() method returns: undefined
The stored value: 20

示例 3

如果 byteOffset 参数的值超出此 DataView 的边界，它将引发 'RangeError' 异常。


<html>
<body>
<script>
	 	const buffer = new ArrayBuffer(8);
	 	const data_view = new DataView(buffer);
	 	const byteOffset = -1;
	 	const value = 10;
	 	document.write("The byteOffset: ", byteOffset);
	 	document.write("<br>The data value: ", value);
	 	try {
	 	 	 //using the setInt8() method
	 	 	 data_view.setInt8(byteOffset, value);
	 	} catch (error) {
	 	 	 document.write("<br>", error);
	 	}
</script>
</body>
</html>

输出

执行上述程序后，将抛出 RangeError 异常。

The byteOffset: -1
The data value: 10
RangeError: Offset is outside the bounds of the DataView
<< JavaScript DataView setInt32() 方法 JavaScript DataView setUint16() 方法 >>