DataView() コンストラクター

DataView() コンストラクターは、 DataView オブジェクトを生成するために使用します。

構文

new DataView(buffer [, byteOffset [, byteLength]])

引数

buffer
既存の ArrayBuffer または SharedArrayBuffer で、新しい DataView オブジェクトの背景となるストレージとして使用されます。
byteOffset 省略可
新しいビューが参照するバッファーの最初のバイトまでのオフセットをバイト単位で指定します。指定されていない場合、バッファービューは最初のバイトから始まります。
byteLength 省略可
バイト配列の要素数です。指定しない場合、ビューの長さはバッファーの長さと一致します。

返値

指定されたデータバッファーを表す DataView オブジェクトです。 (これはおそらくあまり役に立たない説明でした。)

返されるオブジェクトは、バイトの配列バッファーの「インタープリター」と考えることができます。 - これは読み書きの際に、バッファー内に正しく収まるように数値を変換する方法を知っています。これは、整数や浮動小数点数の変換、エンディアン、その他バイナリ形式で数値を表現する際の詳細を扱うことを意味します。

例外

RangeError

byteOffsetbyteLength 引数の値がバッファーの末尾を超えて広がる結果になる場合に発生します。

例えば、バッファーが16バイトの長さで、 byteOffset が8バイト、 byteLength が10バイトの場合、バッファーの全長を2バイト超えるビューを展開しようとするので、このエラーが発生します。

DataView の使用

var buffer = new ArrayBuffer(16);
var view = new DataView(buffer, 0);

view.setInt16(1, 42);
view.getInt16(1); // 42

仕様書

仕様書
ECMAScript (ECMA-262)
DataView constructor の定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報