CKTIS / JavaScript
parseFloat — eine Zahl am Anfang eines Textes lesen
parseFloat wandelt sein Argument in Text um und liest den längsten gültigen Anfang in dezimaler Zahlenschreibweise. Führende Leerzeichen und nachfolgenden Text ignoriert die Funktion; kann sie keine Zahl lesen, gibt sie NaN zurück.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
parseFloat(string)parseFloat(string) ist eine globale ECMAScript-Funktion, keine Browser-API. Sie wandelt ihr Argument zunächst in Text um, überspringt führende Leerzeichen und liest den längsten gültigen numerischen Anfang. Sie gibt einen Wert vom Typ Number zurück; Number.parseFloat verweist auf dieselbe Funktion.
Die Funktion erkennt ein optionales Vorzeichen + oder -, einen Dezimalpunkt, einen Exponenten mit e oder E sowie Infinity. Der restliche Text wird ignoriert: parseFloat("12.5px") gibt 12.5 zurück, und parseFloat("1e") gibt 1 zurück. Ein Komma ist kein Dezimaltrennzeichen: parseFloat("3,14") gibt 3 zurück. Hexadezimale Präfixe werden nicht unterstützt: parseFloat("0x10") gibt 0 zurück.
Leerer Text oder das Fehlen eines gültigen numerischen Anfangs ergibt NaN. Prüfe das Ergebnis mit Number.isNaN(result), nicht mit result === NaN. Eine erfolgreich gelesene Zahl kann unendlich sein oder auf die Genauigkeit von Number gerundet werden; Number.isFinite(result) weist sowohl NaN als auch Unendlichkeiten zurück.
Verwende diese Funktion nicht, um ein vollständiges Zahlenfeld zu validieren: Sie akzeptiert auch "12abc". Number(string) verlangt, dass der gesamte Text gültig ist, nachdem umgebende Leerzeichen ignoriert wurden, wandelt leeren Text jedoch in 0 um. parseFloat akzeptiert kein Argument für die Zahlenbasis.
Beispiele
const inputs = [" -12.5px", "1.25e2kg", "3,14", "0x10", "abc", ""];
for (const input of inputs) {
console.log(`${JSON.stringify(input)} => ${parseFloat(input)}`);
}Ergebnis
" -12.5px" => -12.5 "1.25e2kg" => 125 "3,14" => 3 "0x10" => 0 "abc" => NaN "" => NaN
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.