Math.fround()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die statische Methode Math.fround() gibt die nächstliegende 32-Bit Einzelpräzisions Gleitkommazahl-Darstellung einer Zahl zurück.

Probieren Sie es aus

Syntax

js
Math.fround(doubleFloat)

Parameter

doubleFloat

Eine Zahl.

Rückgabewert

Die nächstliegende 32-Bit Einzelpräzisions Gleitkommazahl-Darstellung von doubleFloat.

Beschreibung

JavaScript verwendet intern 64-Bit Doppelpräzisions-Gleitkommazahlen, die eine sehr hohe Präzision bieten. Allerdings arbeiten Sie manchmal mit 32-Bit Gleitkommazahlen, zum Beispiel, wenn Sie Werte aus einem Float32Array lesen. Dies kann Verwirrung stiften: Der Vergleich einer 64-Bit Gleitkommazahl mit einer 32-Bit Gleitkommazahl auf Gleichheit kann fehlschlagen, obwohl die Zahlen scheinbar identisch sind.

Um dies zu lösen, kann Math.fround() verwendet werden, um die 64-Bit Gleitkommazahl in eine 32-Bit Gleitkommazahl umzuwandeln. Intern behandelt JavaScript die Zahl weiterhin als 64-Bit Gleitkommazahl, es wird lediglich ein "Round to Even" am 23. Bit der Mantisse durchgeführt und alle folgenden Mantissenbits werden auf 0 gesetzt. Wenn die Zahl außerhalb des Bereichs einer 32-Bit Gleitkommazahl liegt, wird Infinity oder -Infinity zurückgegeben.

Da fround() eine statische Methode von Math ist, verwenden Sie sie immer als Math.fround(), anstatt als Methode eines von Ihnen erstellten Math-Objekts (Math ist kein Konstruktor).

Beispiele

Verwendung von Math.fround()

Die Zahl 1.5 kann im binären Zahlensystem genau dargestellt werden und ist in 32-Bit und 64-Bit identisch:

js
Math.fround(1.5); // 1.5
Math.fround(1.5) === 1.5; // true

Allerdings kann die Zahl 1.337 im binären Zahlensystem nicht genau dargestellt werden, daher unterscheidet sie sich in 32-Bit und 64-Bit:

js
Math.fround(1.337); // 1.3370000123977661
Math.fround(1.337) === 1.337; // false

21502^150 ist zu groß für eine 32-Bit Gleitkommazahl, daher wird Infinity zurückgegeben:

js
2 ** 150; // 1.42724769270596e+45
Math.fround(2 ** 150); // Infinity

Spezifikationen

Specification
ECMAScript Language Specification
# sec-math.fround

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch