Math.f16round() は静的メソッドで、数値に最も近い16 ビット半精度浮動小数点表現を返します。

試してみましょう

console.log(Math.f16round(5.5));// 予想される結果: 5.5console.log(Math.f16round(5.05));// 予想される結果: 5.05078125console.log(Math.f16round(5));// 予想される結果: 5console.log(Math.f16round(-5.05));// 予想される結果: -5.05078125

構文

Math.f16round(doubleFloat)

引数

doubleFloat

数値です。

返値

doubleFloat に最も近い16 ビット半精度浮動小数点表現です。

解説

Math.f16round は、Math.fround() の 16 ビット版です。これは、Float16Array から読み込む場合など、 float16 の数値を操作する際に、意図通りに動作します。内部的には、JavaScript で数値は引き続き 64 ビット浮動小数点数として扱い、仮数部の 10 ビット目で「偶数への丸め」を行い、続く仮数部のビットすべてを 0 に設定します。数値が 16 ビット浮動小数点数の範囲外である場合、Infinity または-Infinity が返値として返されます。

f16round() はMath の静的メソッドであるため、生成したMath オブジェクトのメソッドとしてではなく、常にMath.f16round() として使用するようにしてください（Math はコンストラクターではありません）。

例

Math.f16round() の使用

1.5 という数字は 2 進法で正確に表すことができ、 16 ビットでも 64 ビットでも同じです。

Math.f16round(1.5); // 1.5Math.f16round(1.5) === 1.5; // true

しかし、 1.337 という数字は 2 進法では正確に表すことができないため、 16 ビットと 64 ビットでは差が出ます。

Math.f16round(1.337); // 1.3369140625Math.f16round(1.337) === 1.337; // false

100000 は 16 ビット浮動小数点では大きすぎるので、Infinity が返されます。

Math.f16round(100000); // Infinity

仕様書

ブラウザーの互換性

関連情報

• Math.f16round のポリフィル (core-js)
• es-shims によるMath.f16round のポリフィル
• Math.fround()
• Math.round()