【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()メソッドは非常に有用な機能を提供します。
構文(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型)を読み取って返します。