Summary
The Int32Array typed array represents an array of twos-complement 32-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
Int32Array(length); Int32Array(typedArray); Int32Array(object); Int32Array(buffer [, byteOffset [, length]]);
For more information about the constructor syntax and the parameters, see TypedArray.
Properties
-
Int32Array.BYTES_PER_ELEMENT -
Returns a number value of the element size.
4in the case of anInt32Array. - Int32Array.length
- Length property whose value is 3.
-
Int32Array.name -
Returns the string value of the constructor name. In the case of the
Int32Arraytype: "Int32Array". -
Int32Array.prototype - Prototype for the TypedArray objects.
Methods
- Int32Array.from()
-
See
Array.from(). Not implemented, see bug 896608. - Int32Array.of()
-
See
Array.of(). Not implemented, see bug 896608.
Int32Array prototype
All Int32Array objects inherit from %TypedArray%.prototype.
Properties
-
Int32Array.prototype.constructor -
Returns the function that created an instance's prototype. This is the
Int32Arrayconstructor by default. -
Int32Array.prototype.bufferRead only -
Returns the
ArrayBufferreferenced by theInt32ArrayFixed at construction time and thus read only. -
Int32Array.prototype.byteLengthRead only -
Returns the length (in bytes) of the
Int32Arrayfrom the start of itsArrayBuffer. Fixed at construction time and thus read only. -
Int32Array.prototype.byteOffsetRead only -
Returns the offset (in bytes) of the
Int32Arrayfrom the start of itsArrayBuffer. Fixed at construction time and thus read only. -
Int32Array.prototype.lengthRead only -
Returns the number of elements hold in the
Int32Array. Fixed at construction time and thus read only.
Methods
-
Int32Array.prototype.copyWithin() -
See
Array.prototype.copyWithin(). -
Int32Array.prototype.move()Unimplemented -
Former non-standard version of
Int32Array.prototype.copyWithin(). -
Int32Array.prototype.set() -
Stores multiple values in the
Int32Array, reading input values from a specified array. -
Int32Array.prototype.subarray() -
Returns a new
Int32Arrayfrom the given start and end element index.
Examples
// From a length var int32 = new Int32Array(2); int32[0] = 42; console.log(int32[0]); // 42 console.log(int32.length); // 2 console.log(int32.BYTES_PER_ELEMENT); // 4 // From an array var arr = new Int32Array([21,31]); console.log(arr[1]); // 31 // From another TypedArray var x = new Int32Array([21, 31]); var y = new Int32Array(x); console.log(y[0]); // 21 // From an ArrayBuffer var buffer = new ArrayBuffer(16); var z = Int32Array(buffer, 0, 4);
Specifications
| Specification | Status | Comment |
|---|---|---|
| Typed Array Specification | Obsolete | Superseded by ECMAScript 6. |
| ECMAScript 6 (ECMA-262) The definition of 'TypedArray constructors' in that specification. |
Draft | Initial definition in an ECMA standard. |
Browser compatibility
Help improve compatibility tables by filling out this 11 question survey.
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 7.0 | 4.0 (2) | 10 | 11.6 | 5.1 |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | 4.0 | (Yes) | 4.0 (2) | 10 | 11.6 | 4.2 |