Float32Array

Float32Array タイプは、32 ビット浮動小数点数 (C 言語の float データタイプに相当します) の配列を表します。

これが設定されると、オブジェクトのメソッドあるいは配列の添字構文 (括弧を用いる表記) を用いて、配列の要素を参照することが可能になります。

コンストラクタの概要

メソッドの概要

属性

定数

要素のサイズ

コンストラクタ

新たな Float32Array オブジェクトを返します。

Float32Array Float32Array(
  unsigned long length
);

Float32Array Float32Array(
  TypedArray array
);

Float32Array Float32Array(
  sequence<type> array
);

Float32Array Float32Array(
  ArrayBuffer buffer,
  optional unsigned long byteOffset,
  optional unsigned long length
);

パラメータ

length

バイト配列内の要素数です。省略した場合、配列ビューの長さはバッファの長さと同じになります。

array

新たな ArrayBuffer にコピーを行う、任意の型付き配列タイプの (Uint8Array のような) オブジェクト、または特定のタイプのオブジェクトがひと続きになったものです。コピー元の配列内にある各値は、新しい配列へコピーされる前に 32 ビット浮動小数点数値に変換されます。

buffer

新たな Float32Array オブジェクトの記憶領域として用いる、既存の ArrayBuffer です。

byteOffset

指定されたバッファ内で新たなビューが参照する、最初のバイト位置を示すオフセットをバイト単位で示します。省略した場合、バッファでの Float32Array のビューは最初のバイト位置から参照し始めます。

戻り値

指定されたデータバッファを示す、新たな Float32Array オブジェクトを返します。

注釈

コンストラクタ一覧の最初の構文 (lengh のみを受け入れるもの) は、指定された数の 32 ビット浮動小数点数値を保持することができる新たな ArrayBuffer オブジェクトを作成し、さらにそのバッファを参照する型付き配列のビューも作成して返します。length は、このような場合に指定する必要があります。

2 番目の構文は、各要素の値が 32 ビット浮動小数点数値に変換されていること以外は指定された配列の複製となる、新たな ArrayBuffer オブジェクトを作成します。

3 番目の構文は同様に、各要素の値が 32 ビット浮動小数点数値に変換されていること以外は指定された JavaScript 配列の複製となる、新たな ArrayBuffer オブジェクトを作成します。

最後のコンストラクタ構文は、指定された ArrayBuffer を記憶領域として用いる、新たな Float32Array オブジェクトを作成します。これは、既存のバッファに異なる形式でアクセスすることを可能にします。byteOffset や length のパラメータを指定した場合は、バッファの一部分のみに対するビューを作成することができます。

発生する例外

INDEX_SIZE_ERR

指定された byteOffset が要素のサイズの倍数ではない、または指定されたビューにおいて byteOffset および length の結果が、バッファの終端を超えることを示します。

メソッド

set()

指定された配列から入力値を読み取り、それら複数の値を型付き配列に格納します。

void set(
  TypedArray array,
  optional unsigned long offset
);

void set(
  type[] array,
  optional unsigned long offset
);

パラメータ

array

値のコピー元になる配列です。コピー元の配列の長さにオフセットの値を加えた結果がコピー先の配列のサイズを超える場合 (このとき例外が発生します) を除き、コピー元の配列からすべての値が宛先の配列にコピーされます。コピー元の配列が型付き配列である場合、2 つの配列は同一の潜在的な ArrayBuffer を共有することがあります。ブラウザは、コピー元のバッファ範囲をインテリジェントにコピー先範囲へコピーします。

offset Optional

コピー先の配列で、コピー元の配列から得た値を書き込み始める位置を示すオフセットです。この値を省略した場合は、0 が指定されたとみなします。よってコピー先の配列の添字 0 から、コピー元の配列の値による上書きが始まります。

subarray()

この Float32Array ビューのために、ArrayBuffer 領域の新たな Float32Array ビューを作成します。

Float32Array subarray(
  long begin,
  optional long end
);

パラメータ

begin

配列内で、新たな Float32Array によって参照される最初の要素を示すオフセットです。

end Optional

配列内で、新たな Float32Array によって参照される最後の要素を示すオフセットです。省略した場合は、begin で指定された要素から最後の要素までのすべてが新たなビューに含まれます。

注釈

begin および end で指定された範囲は、カレントの配列で有効な添字の範囲に修正されます。例えば新たな配列の長さの算出値が負数になる場合は、0 に修正されます。begin か end のいずれかが負数である場合は、配列の先頭からの添字ではなく末尾からの添字を指します。

参考情報

• Typed Array Specification
• JavaScript typed arrays