Uint16Array
Summary
A typed array of 16-bit unsigned integer values. The contents are initialized to 0. If the requested number of bytes could not be allocated an exception is raised.
Syntax
uint16Array = new Uint16Array( length );
uint16Array = new Uint16Array( array );
uint16Array = new Uint16Array( buffer , byteOffset , length );
- uint16Array
- Required. The variable name to which the Uint16Array object is assigned.
- length
- Specifies the length (in bytes) of the array.
- array
- The array (or typed array) that is contained in this array… The contents are initialized to the contents of the given array or typed array, with each element converted to the Uint16 type.
- buffer
- The ArrayBuffer that the Uint16Array represents.
- byteOffset
- Optional. Specifies the offset in bytes from the start of the buffer at which the Uint16Array should begin.
- length
- The length of the array.
Examples
The following example shows how to use a Uint16Array object to process the binary data acquired from an XmlHttpRequest:
var req = new XMLHttpRequest();
req.open('GET', "http://www.example.com");
req.responseType = "arraybuffer";
req.send();
req.onreadystatechange = function () {
if (req.readyState === 4) {
var buffer = req.response;
var dataview = new DataView(buffer);
var ints = new Uint16Array(buffer.byteLength / 2);
for (var i = 0; i < ints.length; i++) {
ints[i] = dataview.getUint16(i * 2);
}
alert(ints[10]);
}
}
Constants
The following table lists the constants of the Uint16Array object.
Constant | Description |
---|---|
BYTES_PER_ELEMENT Constant | The size in bytes of each element in the array. |
Properties
The following table lists the constants of the Uint16Array object.
Property | Description |
---|---|
buffer Property | Read-only. Gets the ArrayBuffer that is referenced by this array. |
byteLength Property | Read-only. The length of this array from the start of its ArrayBuffer, in bytes, as fixed at construction time. |
byteOffset Property | Read-only. The offset of this array from the start of its ArrayBuffer, in bytes, as fixed at construction time. |
length Property | The length of the array. |
Methods
The following table lists the methods of the Uint16Array object.
Method | Description |
---|---|
get Method | Omittable. Gets the element at the specified index. |
set Method (Uint16Array) | Sets a value or an array of values. |
subarray Method (Uint16Array) | Gets a new Uint16Array view of the ArrayBuffer store for this array. |
Attributions
Microsoft Developer Network: Article