Int16Array() コンストラクター
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Int16Array() は型付き配列のコンストラクターで、プラットフォームのバイト順による 2 の補数形式の 16 ビット符号付き整数値の配列を生成します。バイト順の制御が必要な場合は、代わりにDataView を使用してください。中身は0 で初期化されます。生成されると、配列の中の要素はオブジェクトのメソッドを使用するか、配列の標準的な添字の構文を使用するか (すなわち、ブラケット構文を使用するか) して参照することができます。
構文
new Int16Array(); // new in ES2017new Int16Array(length);new Int16Array(typedArray);new Int16Array(object);new Int16Array(buffer [, byteOffset [, length]]);
引数
lengthlength引数付きで呼び出されると、メモリ内に内部的な配列バッファーを作成し、大きさはlengthをBYTES_PER_ELEMENTで乗じたバイト数になり、ゼロになることもあります。typedArraytypedArray引数付きで呼び出されると、これはあらゆる型付き配列型 (例えばInt32Array) にすることができますが、typedArrayを新しい型付き配列にコピーします。typedArrayの中のそれぞれの値は、新しい配列にコピーされる前にコンストラクターの対応する型に変換されます。新しい型付き配列の長さはtypedArray引数の長さと同じになります。objectobject引数付きで呼び出されると、あたかもTypedArray.from()メソッドであるかのように新しい型付き配列が生成されます。buffer,byteOffset,lengthbufferと、オプションでbyteOffsetとlength引数を指定して呼び出されると、指定されたArrayBufferを表示する型付き配列ビューが生成されます。byteOffsetおよびlength引数は、型付き配列ビューが表示するメモリ範囲を指定する。 両方を省略した場合はbufferの全てを表示し、lengthのみを省略した場合はbufferの残りを表示します。
例
様々な方法による Int16Array の生成
// From a lengthvar int16 = new Int16Array(2);int16[0] = 42;console.log(int16[0]); // 42console.log(int16.length); // 2console.log(int16.BYTES_PER_ELEMENT); // 2// From an arrayvar arr = new Int16Array([21, 31]);console.log(arr[1]); // 31// From another TypedArrayvar x = new Int16Array([21, 31]);var y = new Int16Array(x);console.log(y[0]); // 21// From an ArrayBuffervar buffer = new ArrayBuffer(8);var z = new Int16Array(buffer, 0, 4);// From an iterablevar iterable = (function* () { yield* [1, 2, 3];})();var int16 = new Int16Array(iterable);// Int16Array[1, 2, 3]仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-typedarray-constructors |