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

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

DataView.prototype.getBigInt64()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

DataView.prototype.getBigInt64()メソッドは、DataViewオブジェクトに格納されたバイナリデータの中から、指定されたバイトオフセット位置から符号付き64ビット整数(BigInt)を読み取るメソッドです。DataViewは、ArrayBufferという生のバイナリデータが格納されたメモリ領域に対して、様々なデータ型(整数や浮動小数点数など)でアクセスするための柔軟なビューを提供します。このメソッドを利用することで、メモリ上の指定された場所から8バイト分のデータを符号付き64ビット整数(BigInt)として読み取ることが可能です。

第一引数には、データの読み取りを開始するバイトオフセット(DataViewの先頭からのバイト単位の位置)を数値で指定します。第二引数にはオプションで、データのバイト順序(エンディアン)を指定する真偽値を渡せます。trueを指定するとリトルエンディアン、falseまたは省略した場合はビッグエンディアンとしてデータを読み込みます。メソッドは、読み取られたBigInt値を返します。

このメソッドは、JavaScriptのNumber型では精度が不足する64ビット整数を扱う際に特に役立ちます。例えば、バイナリファイルの解析、ネットワークプロトコル処理、あるいはWebAssemblyなどの他の言語と連携してデータを操作する場面で利用されます。データのバイト列を正確に、かつ期待するデータ型で読み出す必要がある低レベルなデータ操作において、DataViewオブジェクトとそのgetBigInt64()メソッドは非常に有用な機能を提供します。

公式リファレンス: DataView.prototype.getBigInt64()

構文(syntax)

1const buffer = new ArrayBuffer(8);
2const dataview = new DataView(buffer);
3const bigIntValue = dataview.getBigInt64(0, true);

引数(parameters)

byteOffset, littleEndian = false

  • byteOffset: number: 読み取るバイト位置を指定する整数
  • littleEndian: boolean = false: データのエンディアン(バイト順)を指定します。trueの場合はリトルエンディアン、false(デフォルト)の場合はビッグエンディアンです。

戻り値(return)

BigInt

指定されたオフセットから、符号付き64ビット整数値(BigInt型)を読み取って返します。

関連コンテンツ

関連プログラミング言語