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.