【JavaScript ECMAScript】DataView::DataView.prototype.getBigUint64インスタンスメソッドの使い方

DataView.prototype.getBigUint64()メソッドは、DataViewオブジェクトに保持されているバイナリデータから、指定されたバイトオフセット位置にある64ビットの符号なし整数（BigInt）を読み取って返すメソッドです。

このメソッドは、メモリ上に存在するバイナリデータを、指定されたフォーマットで読み書きするために使用されるDataViewオブジェクトの機能の一つです。特に、ネットワークを通じて送受信されるデータや、ファイルの内容など、バイト単位で厳密なデータ構造を持つ情報を扱う際に利用されます。

メソッドには、DataViewの先頭から読み取りを開始するバイト位置を示すbyteOffset引数を指定します。また、オプションとしてlittleEndian引数（真偽値）を指定できます。littleEndianがtrueの場合、データはリトルエンディアン形式で解釈されます。falseの場合、または引数が省略された場合は、ビッグエンディアン形式で解釈されます。

戻り値はJavaScriptのBigInt型であり、0から約1.84×10^19までの非常に大きな符号なし整数値を表現します。JavaScriptの通常のNumber型では53ビットまでの整数しか正確に扱えないため、64ビットの整数値を正確に取り扱うにはこのBigInt型が不可欠です。指定されたbyteOffsetがDataViewの範囲外であったり、読み取ろうとする64ビット分のデータがDataViewの境界を超える場合は、RangeErrorが発生しますので、適切なオフセットとデータ長を考慮して使用する必要があります。

Copy
1const buffer = new ArrayBuffer(8);
2const dataView = new DataView(buffer);
3const value = dataView.getBigUint64(0);

byteOffset, littleEndian = false

• byteOffset: number: 読み取るバイト位置を指定します。
• littleEndian: boolean = false: 値をリトルエンディアン形式で読み取るかどうかを指定します。falseの場合はビッグエンディアン形式で読み取ります。

BigInt

指定されたオフセットから、64ビットの符号なし整数値をBigInt型で取得します。