Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【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バイトの符号付き整数を読み取ります。

関連コンテンツ

関連プログラミング言語