strtof, strtod, strtold

Interpretiert einen Gleitkommawert in der Byte-Zeichenkette, auf die str zeigt.

Die Funktion verwirft alle Leerzeichen (wie durch isspace bestimmt), bis das erste Nicht-Leerzeichen gefunden wird. Dann nimmt sie so viele Zeichen wie möglich, um eine gültige Gleitkommadarstellung zu bilden, und wandelt diese in einen Gleitkommawert um. Der gültige Gleitkommawert kann einer der folgenden sein:

• Dezimale Gleitkomma-Ausdrücke. Es besteht aus den folgenden Teilen:

• (optional) Plus- oder Minuszeichen
• Nichtleere Folge von Dezimalziffern, optional mit Dezimaltrennzeichen (wie durch die aktuelle C- Locale bestimmt) (definiert die Signifikande)
• (optional) e oder E gefolgt von optionalem Minus- oder Pluszeichen und nichtleerer Folge von Dezimalziffern (definiert den Exponenten zur Basis 10 )

• jeder andere Ausdruck, der von der aktuell installierten C locale akzeptiert werden kann.

Die Funktion setzt den Zeiger, auf den str_end zeigt, so, dass er auf das Zeichen nach dem letzten interpretierten Zeichen zeigt. Wenn str_end ein Nullzeiger ist, wird er ignoriert.

Parameter

Rückgabewert

Fließkommawert, der dem Inhalt von str bei Erfolg entspricht. Falls der konvertierte Wert außerhalb des Bereichs des entsprechenden Rückgabetyps liegt, tritt ein Bereichsfehler auf ( errno wird auf ERANGE gesetzt) und HUGE_VAL , HUGE_VALF oder HUGE_VALL wird zurückgegeben. Falls keine Konvertierung durchgeführt werden kann, wird ​ 0 ​ zurückgegeben.

Beispiel

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    // parsing with error handling
    const char* p = "111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz";
    printf("Parsing '%s':\n", p);
    char* end = NULL;
    for (double f = strtod(p, &end); p != end; f = strtod(p, &end))
    {
        printf("'%.*s' -> ", (int)(end - p), p);
        p = end;
        if (errno == ERANGE)
        {
            printf("range error, got ");
            errno = 0;
        }
        printf("%f\n", f);
    }
    // parsing without error handling
    printf("\"  -0.0000000123junk\"  -->  %g\n", strtod("  -0.0000000123junk", NULL));
    printf("\"junk\"                 -->  %g\n", strtod("junk", NULL));
}

Parsing '111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz':
'111.11' -> 111.110000
' -2.22' -> -2.220000
' Nan' -> nan
' nan(2)' -> nan
' inF' -> inf
' 0X1.BC70A3D70A3D7P+6' -> 111.110000
'  1.18973e+4932' -> range error, got inf
"  -0.0000000123junk"  -->  -1.23e-08
"junk"                 -->  0

Referenzen

Siehe auch