Int16Array

Summary

The Int16Array typed array represents an array of twos-complement 16-bit signed integers in the platform byte order. If control over byte order is needed, use DataView instead. The contents are initialized to 0. Once established, you can reference elements in the array using the object's methods, or using standard array index syntax (that is, using bracket notation).

Syntax

Int16Array(length);
Int16Array(typedArray);
Int16Array(object);
Int16Array(buffer [, byteOffset [, length]]);

For more information about the constructor syntax and the parameters, see TypedArray.

Properties

Int16Array.BYTES_PER_ELEMENT

Returns a number value of the element size. 2 in the case of an Int16Array.

Int16Array.length

Length property whose value is 3.

Int16Array.name

Returns the string value of the constructor name. In the case of the Int16Array type: "Int16Array".

Int16Array.prototype

Prototype for the TypedArray objects.

Methods

Int16Array.from()

See Array.from(). Not implemented, see bug 896608.

Int16Array.of()

See Array.of(). Not implemented, see bug 896608.

Int16Array prototype

All Int16Array objects inherit from %TypedArray%.prototype.

Properties

Int16Array.prototype.constructor

Returns the function that created an instance's prototype. This is the Int16Array constructor by default.

Int16Array.prototype.buffer Read only

Returns the ArrayBuffer referenced by the Int16Array Fixed at construction time and thus read only.

Int16Array.prototype.byteLength Read only

Returns the length (in bytes) of the Int16Array from the start of its ArrayBuffer. Fixed at construction time and thus read only.

Int16Array.prototype.byteOffset Read only

Returns the offset (in bytes) of the Int16Array from the start of its ArrayBuffer. Fixed at construction time and thus read only.

Int16Array.prototype.length Read only

Returns the number of elements hold in the Int16Array. Fixed at construction time and thus read only.

Methods

Int16Array.prototype.copyWithin()

See Array.prototype.copyWithin().

Int16Array.prototype.entries()

Returns a new Array Iterator object that contains the key/value pairs for each index in the array.

Int16Array.prototype.keys()

Returns a new Array Iterator that contains the keys for each index in the array.

Int16Array.prototype.move() Unimplemented

Former non-standard version of Int16Array.prototype.copyWithin().

Int16Array.prototype.set()

Stores multiple values in the Int16Array, reading input values from a specified array.

Int16Array.prototype.subarray()

Returns a new Int16Array from the given start and end element index.

Int16Array.prototype.values()

Returns a new Array Iterator object that contains the values for each index in the array.

Int16Array.prototype[@@iterator]()

Returns a new Array Iterator object that contains the values for each index in the array.

Examples

// From a length
var int16 = new Int16Array(2);
int16[0] = 42;
console.log(int16[0]); // 42
console.log(int16.length); // 2
console.log(int16.BYTES_PER_ELEMENT); // 2

// From an array
var arr = new Int16Array([21,31]);
console.log(arr[1]); // 31

// From another TypedArray
var x = new Int16Array([21, 31]);
var y = new Int16Array(x);
console.log(y[0]); // 21

// From an ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = new Int16Array(buffer, 0, 4);

Specifications

Browser compatibility

See also

• JavaScript typed arrays
• ArrayBuffer
• DataView