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

JavaScript DataView setInt16() 方法

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

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

语法

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


 setInt16(byteOffset, value, littleEndian)

参数

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

  • byteOffset - DataView 中将存储字节的位置。
  • value - 需要存储的有符号 16 位整数。
  • littleEndian - 它指示数据值是以 little-endian 还是 big-endian 格式存储。

返回值

此方法返回 '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
<< JavaScript DataView setFloat64() 方法 JavaScript DataView setInt32() 方法 >>