parseFloat()

Probieren Sie es aus

function circumference(r) {
  return parseFloat(r) * 2.0 * Math.PI;
}

console.log(circumference(4.567));
// Expected output: 28.695307297889173

console.log(circumference("4.567abcdefgh"));
// Expected output: 28.695307297889173

console.log(circumference("abcdefgh"));
// Expected output: NaN

Syntax

parseFloat(string)

Parameter

string

Der zu analysierende Wert, erzwingt die Umwandlung in einen String. Fhrende Leerzeichen in diesem Argument werden ignoriert.

Rckgabewert

Eine Gleitkommazahl, die aus dem gegebenen string analysiert wurde, oder NaN, wenn das erste Nicht-Leerzeichen-Zeichen nicht in eine Zahl umgewandelt werden kann.

Beschreibung

Die parseFloat-Funktion konvertiert ihr erstes Argument in einen String, analysiert diesen String als ein Dezimalzahlen-Literal und gibt dann eine Zahl oder NaN zurck. Die von ihr akzeptierte Zahlensyntax lsst sich wie folgt zusammenfassen:

• Die von parseFloat() akzeptierten Zeichen sind das Pluszeichen (+), das Minuszeichen (- U+002D HYPHEN-MINUS), Dezimalziffern (0 9), der Dezimalpunkt (.), das Exponentenzeichen (e oder E) und das Literal "Infinity".
• Die +/- Zeichen knnen nur streng am Anfang des Strings oder unmittelbar nach dem e/E Zeichen erscheinen. Der Dezimalpunkt kann nur einmal und nur vor dem e/E Zeichen erscheinen. Das e/E Zeichen kann nur einmal erscheinen und nur, wenn mindestens eine Ziffer davor vorhanden ist.
• Fhrende Leerzeichen im Argument werden abgeschnitten und ignoriert.
• parseFloat() kann auch Infinity oder -Infinity analysieren und zurckgeben, wenn der String mit "Infinity" oder "-Infinity" beginnt, denen keine oder mehr Leerzeichen vorangestellt sind.
• parseFloat() whlt das lngste Teilstring ausgehend vom Anfang, das ein gltiges Zahlenliteral erzeugt. Wenn es auf ein ungltiges Zeichen stt, gibt es die Zahl zurck, die bis zu diesem Punkt dargestellt wurde, und ignoriert das ungltige Zeichen sowie alle folgenden Zeichen.
• Wenn das erste Zeichen des Arguments kein legales Zahlenliteral gem obiger Syntax beginnen kann, gibt parseFloat NaN zurck.

Syntaxmig analysiert parseFloat() ein Teilset der Syntax, das die Number()-Funktion akzeptiert. Namentlich untersttzt parseFloat() keine nicht-dezimalen Literale mit 0x, 0b oder 0o Prfixen, untersttzt aber alles andere. parseFloat() ist jedoch toleranter als Number(), da es nachgestellte ungltige Zeichen ignoriert, die Number() dazu bringen wrden, NaN zurckzugeben.

hnlich wie Zahlenliterale und Number(), kann die von parseFloat() zurckgegebene Zahl nicht genau der Zahl entsprechen, die durch den String dargestellt wird, aufgrund von Gleitkomma-Bereich und Ungenauigkeit. Bei Zahlen auerhalb des -1.7976931348623158e+308 1.7976931348623158e+308 Bereichs (siehe Number.MAX_VALUE) wird -Infinity oder Infinity zurckgegeben.

Beispiele

Verwendung von parseFloat()

Die folgenden Beispiele geben alle 3.14 zurck:

parseFloat(3.14);
parseFloat("3.14");
parseFloat("  3.14  ");
parseFloat("314e-2");
parseFloat("0.0314E+2");
parseFloat("3.14some non-digit characters");
parseFloat({
  toString() {
    return "3.14";
  },
});

parseFloat() gibt NaN zurck

Das folgende Beispiel gibt NaN zurck:

parseFloat("FF2");

Anekdotisch, da der String NaN selbst eine ungltige Syntax ist, wie sie von parseFloat() akzeptiert wird, liefert das bergeben von "NaN" ebenfalls NaN.

parseFloat("NaN"); // NaN

Rckgabe von Infinity

Infinity-Werte werden zurckgegeben, wenn die Zahl auerhalb des Bereichs des Doppelprzisions-64-Bit IEEE 754-2019-Formats liegt:

parseFloat("1.7976931348623159e+308"); // Infinity
parseFloat("-1.7976931348623159e+308"); // -Infinity

Infinity wird auch zurckgegeben, wenn der String mit "Infinity" oder "-Infinity" beginnt:

parseFloat("Infinity"); // Infinity
parseFloat("-Infinity"); // -Infinity

Interaktion mit BigInt-Werten

parseFloat() verarbeitet keine BigInt-Werte. Es stoppt am n-Zeichen und behandelt den vorhergehenden String als normale ganze Zahl, mit mglichem Przisionsverlust. Wenn ein BigInt-Wert an parseFloat() bergeben wird, wird er in einen String konvertiert, und der String wird als Gleitkommazahl analysiert, was ebenfalls zu einem Przisionsverlust fhren kann.

parseFloat(900719925474099267n); // 900719925474099300
parseFloat("900719925474099267n"); // 900719925474099300

Sie sollten den String an die BigInt()-Funktion bergeben, ohne das nachgestellte n-Zeichen.

BigInt("900719925474099267");
// 900719925474099267n

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• parseInt()
• Number.parseFloat()
• Number.parseInt()
• Number.prototype.toFixed()