まくろぐ
更新: / 作成:

Typed Array とは

JavaScript の配列型には、汎用型の Array の他にも、Int32Array のような、特定の型の値だけしか格納できない配列型が用意されています。 このような配列型のことを Typed Array と呼びます。 イメージとしては、C 言語の int 配列や float 配列に近いです。

例えば、WebGL で頂点属性(座標や色)の配列を用意するようなケースでは、その中の要素の型はすべて float 型に統一されていたりするので、汎用型の Array ではなく、Float32Array を使用することでメモリ効率がよくなります。

Typed Array には下記のようなものが用意されています。

型名バイト数値の範囲説明(対応するC言語の型)
Int8Array1-128 ~ 1278-bit sined integer (int8_t)
Uint8Array10 ~ 2558-bit unsigned integer (uint8_t)
Int16Array2-32768 ~ 3276716-bit signed integer (int16_t)
Uint16Array20 ~ 6553516-bit unsigned integer (uint16_t)
Int32Array4-2147483648 ~ 214748364732-bit signed integer (int32_t)
Uint32Array40 ~ 429496729532-bit unsinged integer (uint32_t)
Float32Array41.2x10-38 ~ 3.4x103832-bit floating point number (float)
Float64Array85.0x10-324 ~ 1.8x1030864-bit floating point number (double)

Typed Array の使い方

Typed Array インスタンスは、型名をコンストラクタとして呼び出すことで生成することができます。 配列リテラルの形で初期値を指定することもできるし、サイズだけ指定してすべての要素が 0 に初期化された Typed Array を作成することもできます。

const arr2 = new Int32Array([0, 1, 2]);  // 初期値を指定
const arr1 = new Int32Array(3);  // デフォルト値の3要素 = [0, 0, 0]

Typed Array は通常の配列と同様に使用できますが、push()pop() のようなサイズ変更を伴う操作はできないようになっています(このあたりも C 言語の配列に近いです)。 その分、効率を重視しているということですね。

const arr = new Int32Array(3);
arr[0] = 777;  // 既存要素の値を変えることは可能
console.log(arr);  //=> [777, 0, 0]
arr.push(888);  // Error!

Typed Array の要素数は length プロパティ、要素 1 つあたりのサイズ(バイト数)は BYTES_PER_ELEMENT で取得することができます。 また、全要素が占めるバイト数 (length * BYTES_PER_ELEMENT) は、byteLength プロパティで取得することができます。

const arr = new Float32Array([0.0, 1.0, 2.0]);
console.log(arr.length);  //=> 3
console.log(arr.BYTES_PER_ELEMENT);  //=> 4
console.log(arr.byteLength);  //=> 12

関連記事

まくろぐ
サイトマップまくへのメッセージ