{{JSRef("Global_Objects", "TypedArray", "Int8Array,Uint8Array,Uint8ClampedArray,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array")}}
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 {{jsxref("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
- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int32Array.BYTES_PER_ELEMENT")}}
-
Returns a number value of the element size.
4
in the case of anInt32Array
. - Int32Array.length
- Length property whose value is 3.
- {{jsxref("TypedArray.name", "Int32Array.name")}}
-
Returns the string value of the constructor name. In the case of the
Int32Array
type: "Int32Array". - {{jsxref("TypedArray.prototype", "Int32Array.prototype")}}
- Prototype for the TypedArray objects.
Methods
- Int32Array.from()
- See {{jsxref("Array.from()")}}. Not implemented, see {{bug(896608)}}.
- Int32Array.of()
- See {{ jsxref("Array.of()")}}. Not implemented, see {{bug(896608)}}.
Int32Array
prototype
All Int32Array
objects inherit from {{jsxref("TypedArray.prototype", "%TypedArray%.prototype")}}.
Properties
-
Int32Array.prototype.constructor
-
Returns the function that created an instance's prototype. This is the
Int32Array
constructor by default. - {{jsxref("TypedArray.prototype.buffer", "Int32Array.prototype.buffer")}} {{readonlyInline}}
-
Returns the {{jsxref("ArrayBuffer")}} referenced by the
Int32Array
Fixed at construction time and thus read only. - {{jsxref("TypedArray.prototype.byteLength", "Int32Array.prototype.byteLength")}} {{readonlyInline}}
-
Returns the length (in bytes) of the
Int32Array
from the start of its {{jsxref("ArrayBuffer")}}. Fixed at construction time and thus read only. - {{jsxref("TypedArray.prototype.byteOffset", "Int32Array.prototype.byteOffset")}} {{readonlyInline}}
-
Returns the offset (in bytes) of the
Int32Array
from the start of its {{jsxref("ArrayBuffer")}}. Fixed at construction time and thus read only. - {{jsxref("TypedArray.prototype.length", "Int32Array.prototype.length")}} {{readonlyInline}}
-
Returns the number of elements hold in the
Int32Array
. Fixed at construction time and thus read only.
Methods
- {{jsxref("TypedArray.prototype.copyWithin()", "Int32Array.prototype.copyWithin()")}}
- See {{jsxref("Array.prototype.copyWithin()")}}.
- {{jsxref("TypedArray.prototype.entries()", "Int32Array.prototype.entries()")}}
-
Returns a new
Array Iterator
object that contains the key/value pairs for each index in the array. - {{jsxref("TypedArray.prototype.keys()", "Int32Array.prototype.keys()")}}
-
Returns a new
Array Iterator
that contains the keys for each index in the array. - {{jsxref("TypedArray.prototype.move()", "Int32Array.prototype.move()")}} {{non-standard_inline}} {{unimplemented_inline}}
- Former non-standard version of {{jsxref("TypedArray.prototype.copyWithin()", "Int32Array.prototype.copyWithin()")}}.
- {{jsxref("TypedArray.prototype.set()", "Int32Array.prototype.set()")}}
-
Stores multiple values in the
Int32Array
, reading input values from a specified array. - {{jsxref("TypedArray.prototype.subarray()", "Int32Array.prototype.subarray()")}}
-
Returns a new
Int32Array
from the given start and end element index. - {{jsxref("TypedArray.prototype.values()", "Int32Array.prototype.values()")}}
-
Returns a new
Array Iterator
object that contains the values for each index in the array. - {{jsxref("TypedArray.prototype.@@iterator()", "Int32Array.prototype[@@iterator]()")}}
-
Returns a new
Array Iterator
object that contains the values for each index in the array.
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 = new Int32Array(buffer, 0, 4);
Specifications
Specification | Status | Comment |
---|---|---|
Typed Array Specification | Obsolete | Superseded by ECMAScript 6. |
{{SpecName('ES6', '#table-45', 'TypedArray constructors')}} | {{Spec2('ES6')}} | Initial definition in an ECMA standard. |
Browser compatibility
{{ CompatibilityTable() }}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 7.0 | {{ CompatGeckoDesktop("2") }} | 10 | 11.6 | 5.1 |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | 4.0 | {{ CompatVersionUnknown() }} | {{ CompatGeckoMobile("2") }} | 10 | 11.6 | 4.2 |
See also
- JavaScript typed arrays
- {{jsxref("ArrayBuffer")}}
- {{jsxref("DataView")}}