【JavaScript ECMAScript】DataView::DataView.prototype.getUint32インスタンスメソッドの使い方
DataView.prototype.getUint32()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
DataView.prototype.getUint32()メソッドは、DataViewオブジェクトが保持するバイナリデータから、指定されたバイトオフセット位置にある符号なし32ビット整数値を読み取るメソッドです。DataViewは、ArrayBufferなどの低レベルなバイナリデータを、特定のデータ型としてアクセスするためのビューを提供するオブジェクトであり、異なるバイトオーダーでのデータ解釈を可能にします。このgetUint32()メソッドは、バイナリデータ内の特定の4バイト(32ビット)をひとまとまりとして、符号なしの整数値として解釈し、その値を取得する役割を担います。
メソッドの第一引数byteOffsetには、DataViewの先頭から数えた、読み取りを開始するバイト単位のオフセット位置を指定します。第二引数littleEndianはオプションで、データのバイトオーダーを指定する真偽値です。trueを指定するとリトルエンディアンで、falseまたは省略した場合はビッグエンディアンで値が読み取られます。この機能は、ネットワークプロトコルやファイルフォーマットなど、特定のバイト順で構造化されたバイナリデータを正確に解析する際に非常に有効です。指定されたbyteOffsetがDataViewの有効な範囲を超えている場合、例外としてTypeErrorが発生します。
公式リファレンス: DataView.prototype.getUint32()
構文(syntax)
1const buffer = new ArrayBuffer(4); 2const dataView = new DataView(buffer); 3const value = dataView.getUint32(0, false);
引数(parameters)
byteOffset, littleEndian = false
- byteOffset: number: 読み取りを開始するバイトオフセット。
- littleEndian: boolean = false: 値がリトルエンディアン形式で格納されているかどうかを示すブール値。falseの場合、ビッグエンディアン形式で読み取られます。
戻り値(return)
Number
指定されたオフセットから、符号なし32ビット整数として解釈された数値を返します。