WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

strtod — einen Stringanfang in double umwandeln

strtod wandelt den Anfang eines Strings in double um. Mit endptr lassen sich fehlgeschlagene Konvertierungen erkennen und der verbleibende Text untersuchen.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <stdlib.h>
double strtod(const char *restrict nptr, char **restrict endptr);

strtod überspringt führende Leerraumzeichen und konvertiert ein Präfix eines nullterminierten Strings. Das Dezimaltrennzeichen hängt von der Locale ab.

Ist endptr nicht null, zeigt *endptr auf den verbleibenden Text. end == text bedeutet, dass keine Konvertierung stattgefunden hat; eine Null allein weist nicht auf einen Fehler hin. Für eine vollständige Verarbeitung muss zusätzlich *end == '\0' gelten.

Setze errno zurück, bevor du Bereichsfehler prüfst. Die Meldung eines Überlaufs über ERANGE hängt von math_errhandling & MATH_ERRNO ab; die Meldung eines Unterlaufs ist implementierungsdefiniert.

Beispiele

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "12.5kg";
    char *end;
    double value = strtod(text, &end);

    if (end == text) {
        puts("no conversion");
        return EXIT_FAILURE;
    }
    printf("value=%.1f; suffix=%s\n", value, end);
    return EXIT_SUCCESS;
}

Ergebnis

value=12.5; suffix=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