【JavaScript ECMAScript】DataView::DataView.prototype.getFloat64インスタンスメソッドの使い方
DataView.prototype.getFloat64()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
DataView.prototype.getFloat64()メソッドは、DataViewインスタンスが内部に保持するバイナリデータの中から、指定されたバイトオフセット位置から8バイトのデータを、IEEE 754形式の64ビット浮動小数点数(倍精度浮動小数点数)として読み取る目的で利用されるメソッドです。
DataViewオブジェクトは、メモリ上の生のバイナリバッファ(ArrayBufferなど)を、特定のデータ型(整数、浮動小数点数など)として解釈し、読み書きするための強力な機能を提供します。getFloat64()メソッドは、特に小数点以下の値を正確に表現する大きな数値をバイナリ形式から抽出する際に不可欠です。
このメソッドは、引数としてbyteOffsetとlittleEndianを受け取ります。byteOffsetは、DataViewの先頭から数えた、データを読み始めるバイト単位のオフセット位置です。例えば、0を指定すればデータの先頭から読み込みを開始します。littleEndianはオプションの真偽値で、データのバイト順序(エンディアンネス)を指定します。trueを指定するとデータはリトルエンディアンとして、falseまたは省略するとビッグエンディアンとして解釈されます。異なるCPUアーキテクチャやネットワークプロトコル間でバイナリデータを交換する際には、バイトオーダーの指定を誤るとデータが正しく解釈されないため、この引数の理解は極めて重要です。
メソッドは、読み取られた64ビット浮動小数点数を数値として返します。もし指定されたbyteOffsetが無効な位置であったり、DataViewの範囲を超えて8バイトを読み取ろうとしたりすると、RangeErrorが発生する可能性がありますので、利用時には注意が必要です。
構文(syntax)
1dataView.getFloat64(byteOffset, littleEndian);
引数(parameters)
byteOffset, littleEndian = false
- byteOffset: number: 読み取るバイト位置を数値で指定します。ArrayBufferの先頭からのオフセットです。
- littleEndian: boolean = false: 値のバイト順序を指定します。trueの場合はリトルエンディアン、falseの場合はビッグエンディアンです。デフォルトはビッグエンディアンです。
戻り値(return)
number
指定されたオフセットにある64ビット浮動小数点数を取得します。