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

DataView.prototype.setFloat16()メソッドは、DataViewオブジェクトが参照するバッファの指定されたバイトオフセットに、16ビット浮動小数点数（半精度浮動小数点数）を書き込むメソッドです。

DataViewオブジェクトは、ArrayBufferなどのバイナリデータバッファ内の任意のオフセットから、さまざまな数値型やバイト順序（エンディアン）でデータを読み書きするためのインターフェースを提供します。このsetFloat16()メソッドは、特に省メモリな浮動小数点表現が必要な場面や、特定のバイナリフォーマット（WebAssemblyやGPUとのデータ連携など）に合わせてデータを操作する際に利用されます。

このメソッドは主に3つの引数を取ります。最初のbyteOffset引数には、データを書き込む開始位置をバイト単位で指定します。次に、value引数には、書き込みたい数値を指定しますが、これは自動的に16ビット浮動小数点数形式に変換されます。最後のlittleEndian引数はオプションで、データのバイト順序を指定します。trueを指定するとリトルエンディアンで、falseまたは省略した場合はビッグエンディアンで書き込まれます。異なるシステム間でバイナリデータをやり取りする際には、このエンディアンの指定が非常に重要となります。

指定されたbyteOffsetがDataViewの範囲外である場合や、書き込みに必要な2バイトのスペースが残っていない場合は、RangeErrorがスローされますので注意が必要です。通常のJavaScriptのNumber型は64ビット浮動小数点数ですが、このメソッドでは16ビットに変換されるため、精度の違いを理解して利用することが求められます。これにより、低レベルなバイナリデータ操作を正確に行うことができます。

Copy
1const buffer = new ArrayBuffer(2);
2const dataView = new DataView(buffer);
3dataView.setFloat16(0, 3.14);

引数なし

引数はありません

戻り値なし

戻り値はありません