Int32Array() コンストラクター

Int32Array() は型付き配列のコンストラクターで、プラットフォームのバイト順による 2 の補数形式の 32 ビット符号付き整数値の配列を生成します。バイト順の制御が必要な場合は、代わりに DataView を使用してください。中身は 0 で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。

構文

new Int32Array(); // new in ES2017
new Int32Array(length);
new Int32Array(typedArray);
new Int32Array(object);
new Int32Array(buffer [, byteOffset [, length]]);

引数

length
length 引数付きで呼び出されると、メモリ内に内部的な配列バッファーを作成し、大きさは lengthBYTES_PER_ELEMENT で乗じたバイト数になり、ゼロになることもあります。
typedArray
typedArray 引数付きで呼び出されると、これはあらゆる型付き配列型 (例えば Int32Array) にすることができますが、 typedArray を新しい型付き配列にコピーします。 typedArray の中のそれぞれの値は、新しい配列にコピーされる前にコンストラクターの対応する型に変換されます。新しい型付き配列の長さは typedArray 引数の長さと同じになります。
object
object 引数付きで呼び出されると、あたかも TypedArray.from() メソッドであるかのように新しい型付き配列が生成されます。
buffer, byteOffset, length
buffer と、オプションで byteOffsetlength 引数を指定して呼び出されると、指定された ArrayBuffer を表示する型付き配列ビューが生成されます。 byteOffset および length 引数は、型付き配列ビューが表示するメモリ範囲を指定する。 両方を省略した場合は buffer の全てを表示し、 length のみを省略した場合は buffer の残りを表示します。

様々な方法による Int32Array の生成

// 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);

// From an iterable
var iterable = function*(){ yield* [1,2,3]; }();
var int32 = new Int32Array(iterable);
// Int32Array[1, 2, 3]

仕様書

仕様書
ECMAScript (ECMA-262)
TypedArray constructors の定義

ブラウザーの互換性

BCD tables only load in the browser

互換性メモ

ECMAScript 2015 から、 Int32Array コンストラクターは構築に new 演算子が必要になりました。 Int32Array コンストラクターを new なしで関数として呼び出すと、 TypeError が発生するようになりました。

var dv = Int32Array([1, 2, 3]);
// TypeError: calling a builtin Int32Array constructor
// without new is forbidden
var dv = new Int32Array([1, 2, 3]);

関連情報