Int32Array

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. 4 in the case of an Int32Array.

Int32Array.length

Length property whose value is 3.

Int32Array.name

Returns the string value of the constructor name. In the case of the Int32Array type: "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 Int32Array constructor by default.

Int32Array.prototype.buffer Read only

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

Int32Array.prototype.byteLength Read only

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

Int32Array.prototype.byteOffset Read only

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

Int32Array.prototype.length Read 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.entries()

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

Int32Array.prototype.keys()

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

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 Int32Array from the given start and end element index.

Int32Array.prototype.values()

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

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

Browser compatibility

See also

• JavaScript typed arrays
• ArrayBuffer
• DataView