CKTIS / C
strtof — Text in float umwandeln
strtof liest den Anfang einer Zeichenkette als float ein. Über den endptr-Zeiger lassen sich eine fehlende Umwandlung und verbleibender Text erkennen.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
float strtof(const char *restrict nptr, char **restrict endptr);strtof aus <stdlib.h> überspringt führende Leerzeichen und wandelt ein Präfix der Zeichenkette in float um. Das Dezimaltrennzeichen hängt vom Locale ab.
Wenn endptr != NULL gilt, speichert die Funktion einen Zeiger auf das erste nicht verarbeitete Zeichen. end == text bedeutet, dass keine Umwandlung stattgefunden hat; der Wert null allein weist keinen Fehler nach. Für eine vollständige Verarbeitung muss zusätzlich *end == '\0' gelten.
Laut N3096 hängt die Bereichsfehlerbehandlung von math_errhandling ab: Bei Überlauf wird ERANGE gesetzt, wenn MATH_ERRNO aktiviert ist; ob dies bei Unterlauf geschieht, ist implementierungsdefiniert. Setzen Sie errno auf null zurück, bevor Sie es prüfen.
Beispiele
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = " 12.5kg";
char *end;
float value = strtof(text, &end);
if (end == text) {
puts("no conversion");
return 1;
}
printf("value=%.1f; rest=%s\n", (double)value, end);
return 0;
}
Ergebnis
value=12.5; rest=kg
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.