This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

Int32Array

Summary

A typed array of 32-bit integer values. The contents are initialized to 0. If the requested number of bytes could not be allocated an exception is raised.

Syntax

int32Array = new Int32Array( length );

int32Array = new Int32Array( array );

int32Array = new Int32Array( buffer , byteOffset , length );
int32Array
Required. The variable name to which the Int32Array 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 Int32 type.
buffer
The ArrayBuffer that the Int32Array represents.
byteOffset
Optional. Specifies the offset in bytes from the start of the buffer at which the Int32Array should begin.
length
The length of the array.

Examples

The following example shows how to use an Int32Array 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 Int32Array(buffer.byteLength / 4);
             for (var i = 0; i < ints.length; i++) {
                 ints[i] = dataview.getInt32(i * 4);
             }
         alert(ints[10]);
         }
     }

Constants

The following table lists the constants of the Int32Array object.

ConstantDescription
BYTES_PER_ELEMENT ConstantThe size in bytes of each element in the array.

Properties

The following table lists the constants of the Int32Array object.

PropertyDescription
buffer PropertyRead-only. Gets the ArrayBuffer that is referenced by this array.
byteLength PropertyRead-only. The length of this array from the start of its ArrayBuffer, in bytes, as fixed at construction time.
byteOffset PropertyRead-only. The offset of this array from the start of its ArrayBuffer, in bytes, as fixed at construction time.
length PropertyThe length of the array.

Methods

The following table lists the methods of the Int32Array object.

MethodDescription
Get MethodOmittable. Gets the element at the specified index.
set Method (Int32Array)Sets a value or an array of values.
subarray Method (Int32Array)Gets a new Int32Array view of the ArrayBuffer store for this array.

Attributions

  • Microsoft Developer Network: Article