【JavaScript ECMAScript】DataView::DataView.prototype.getInt8インスタンスメソッドの使い方
DataView.prototype.getInt8()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
DataView.prototype.getInt8()メソッドは、DataViewオブジェクトに格納されたバイナリデータから、符号付き8ビット整数を読み取るメソッドです。DataViewは、ArrayBufferと呼ばれる生データが格納されたメモリ領域に対して、様々なデータ型で値を読み書きするためのインターフェースを提供します。
このgetInt8()メソッドは、特定のDataViewインスタンスが指し示すバイナリデータの中から、指定されたバイトオフセットの位置から1バイト分のデータを符号付き8ビット整数として読み込み、その数値を返します。符号付き8ビット整数は、-128から127までの範囲の整数値を表します。
メソッドを使用する際には、まず読み取りを開始したいDataView内の位置をバイト単位で指定するbyteOffset引数が必要です。このbyteOffsetがDataViewの有効な範囲外である場合や、読み取りに必要なバイト数(この場合は1バイト)がDataViewの末尾を超える場合には、RangeErrorが発生しますのでご注意ください。
システムエンジニアとしてバイナリデータを直接操作する場面では、特定の位置から正確な形式でデータを抽出することが不可欠であり、このgetInt8()メソッドはそのような低レベルなデータアクセスを安全かつ効率的に行うために利用されます。
公式リファレンス: DataView.prototype.getInt8()
構文(syntax)
1const buffer = new ArrayBuffer(1); 2const dataView = new DataView(buffer); 3 4// オフセット0から符号付き8ビット整数を読み込む 5const value = dataView.getInt8(0);
引数(parameters)
byteOffset, littleEndian = false
- byteOffset: number: 読み取るバイトの開始位置を指定する整数
- littleEndian: boolean = false: バイトオーダーがリトルエンディアンかどうかを指定する真偽値。デフォルトはfalse(ビッグエンディアン)
戻り値(return)
Number
指定されたオフセットから、1バイトの符号付き整数を読み取ります。