javascript instance method
DataView.prototype.setInt16()
The setInt16() method of DataView instances takes a number and stores it as a 16-bit signed integer in the 2 bytes starting at the specified byte offset of this DataView. There is no alignment constraint; multi-byte values may be stored at any offset within bounds.
Interactive exampleOpen the canonical MDN source to run this embedded demo.
// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);
const view = new DataView(buffer);
view.setInt16(1, 32767); // Max signed 16-bit integer
console.log(view.getInt16(1));
// Expected output: 32767
Syntax
setInt16(byteOffset, value)
setInt16(byteOffset, value, littleEndian)
Parameters
byteOffset- : The offset, in bytes, from the start of the view to store the data in.
value- : The value to set. For how the value is encoded in bytes, see Value encoding and normalization.
littleEndianOptional- : Indicates whether the data is stored in little- or big-endian format. If
falseorundefined, a big-endian value is written.
- : Indicates whether the data is stored in little- or big-endian format. If
Return value
Exceptions
RangeError- : Thrown if the
byteOffsetis set such that it would store beyond the end of the view.
- : Thrown if the
Examples
Using setInt16()
const buffer = new ArrayBuffer(10);
const dataview = new DataView(buffer);
dataview.setInt16(0, 3);
dataview.getInt16(1); // 768
Specifications
SpecificationsStandards references are available on the canonical MDN page.
Browser compatibility
Browser compatibilityCompatibility data is available on the canonical MDN page.