atof

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für Zeichenketten

Null-terminierte Byte-Strings

Null-terminierte Multibyte-Strings

Null-terminierte breite Zeichenketten

 

Null-terminierte Byte-Strings

Funktionen
Zeichenmanipulation
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
Konvertierungen zu und von numerischen Formaten
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtouimax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
Stringmanipulation
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
Stringuntersuchung
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
Speichermanipulation
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
Sonstiges
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

Definiert im Header <stdlib.h>
double atof( const char* str );

Interpretiert einen Fließkommawert in einer Byte-Zeichenkette, auf die von str gezeigt wird.

Die Funktion verwirft alle Whitespace-Zeichen (wie von isspace bestimmt), bis das erste Nicht-Whitespace-Zeichen gefunden wird. Dann nimmt sie so viele Zeichen wie möglich, um eine gültige Fließkommadarstellung zu bilden, und konvertiert sie in einen Fließkommawert. Der gültige Fließkommawert kann einer der folgenden sein:

• Dezimale Gleitkomma-Ausdrücke. Sie bestehen aus den folgenden Teilen:

• (optional) Vorzeichen (+ oder -)
• nicht-leere Folge von Dezimalziffern, die optional ein Dezimalpunktzeichen enthält (wie von der aktuellen C Locale bestimmt) (definiert den Signifikand)
• (optional) e oder E gefolgt von einem optionalen Minus- oder Pluszeichen und einer nichtleeren Sequenz von Dezimalziffern (definiert den Exponenten zur Basis 10)

Hexadezimale Gleitkomma-Ausdrücke. Sie bestehen aus den folgenden Teilen: (optional) Vorzeichen (+ oder -) 0x oder 0X nicht-leere Folge von Hexadezimalziffern, die optional ein Dezimalpunktzeichen enthält (wie von der aktuellen C Locale bestimmt) (definiert den Signifikand) (optional) p oder P gefolgt von einem optionalen Minus- oder Pluszeichen und einer nichtleeren Sequenz von Dezimalziffern (definiert den Exponenten zur Basis 2) Unendlichkeits-Ausdrücke. Sie bestehen aus den folgenden Teilen: (optional) Vorzeichen (+ oder -) INF oder INFINITY (Groß-/Kleinschreibung wird ignoriert) Nicht-eine-Zahl-Ausdrücke. Sie bestehen aus den folgenden Teilen: (optional) Vorzeichen (+ oder -) NAN oder NAN(char_sequence ) (Groß-/Kleinschreibung des Teils NAN wird ignoriert). char_sequence darf nur Ziffern, lateinische Buchstaben und Unterstriche enthalten. Das Ergebnis ist ein Quiet-NaN-Gleitkommawert.

(seit C99)

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

Parameter

str

-

Zeiger auf die nullterminierte Byte-Zeichenkette, die interpretiert werden soll

Rückgabewert

double Wert, der dem Inhalt von str im Erfolgsfall entspricht. Wenn der konvertierte Wert außerhalb des Bereichs des Rückgabetyps liegt, ist der Rückgabewert undefiniert. Wenn keine Konvertierung durchgeführt werden kann, wird 0.0 zurückgegeben.

Hinweise

Der Name steht für "ASCII zu Float".

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    printf("%g\n", atof("  -0.0000000123junk"));
    printf("%g\n", atof("0.012"));
    printf("%g\n", atof("15e16"));
    printf("%g\n", atof("-0x1afp-2"));
    printf("%g\n", atof("inF"));
    printf("%g\n", atof("Nan"));
    printf("%g\n", atof("1.0e+309"));   // UB: out of range of double
    printf("%g\n", atof("0.0"));
    printf("%g\n", atof("junk"));       // no conversion can be performed
}

Mögliche Ausgabe

-1.23e-08
0.012
1.5e+17
-107.75
inf
nan
inf
0
0

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.22.1.1 Die Funktion atof (p: TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.22.1.1 Die Funktion atof (p: TBD)

• C11-Standard (ISO/IEC 9899:2011)

• 7.22.1.1 Die Funktion atof (p: 341)

• C99-Standard (ISO/IEC 9899:1999)

• 7.20.1.1 Die Funktion atof (p: 307)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.10.1.1 Die Funktion atof

Siehe auch

strtofstrtodstrtold (C99)(C99)	konvertiert einen Byte-String in einen Gleitkommawert (Funktion)
C++ Dokumentation für atof