WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen