Namespaces
Variants

std:: atof

From cppreference.net
C++
Text processing library
Null-terminated byte strings
Definiert in Header <cstdlib>
double atof ( const char * str ) ;

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

Die Funktion verwirft alle Leerzeichen (wie durch std::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 konvertiert diese in einen Gleitkommawert. 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 )
  • hexadezimale Gleitkomma-Ausdrücke. Sie bestehen aus folgenden Teilen:
  • (optional) Plus- oder Minuszeichen
  • 0x oder 0X
  • nicht-leere Folge hexadezimaler Ziffern, optional mit Dezimaltrennzeichen (wie durch die aktuelle C- Locale bestimmt) (definiert die Signifikande)
  • (optional) p oder P gefolgt von optionalem Minus- oder Pluszeichen und nicht-leerer Folge dezimaler Ziffern (definiert den Exponenten zur Basis 2 )
  • Unendlichkeits-Ausdrücke. Sie bestehen aus folgenden Teilen:
  • (optional) Plus- oder Minuszeichen
  • INF oder INFINITY Groß-/Kleinschreibung wird ignoriert
  • Keine-Zahl-Ausdrücke. Sie bestehen aus folgenden Teilen:
  • (optional) Plus- oder Minuszeichen
  • NAN oder NAN( char_sequence  ) Groß-/Kleinschreibung des NAN Teils wird ignoriert. char_sequence darf nur Ziffern, lateinische Buchstaben und Unterstriche enthalten. Das Ergebnis ist ein stiller NaN-Gleitkommawert.
(seit C++11)
  • jeder andere Ausdruck, der von der aktuell installierten C Locale akzeptiert werden kann.

Inhaltsverzeichnis

Parameter

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

Rückgabewert

double Wert entsprechend dem Inhalt von str bei Erfolg. 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.

Beispiel

Diesen Code ausführen 
#include <cstdlib>
#include <iostream>
int main()
{
    std::cout << std::atof("0.0000000123") << '\n'
              << std::atof("0.012") << '\n'
              << std::atof("15e16") << '\n'
              << std::atof("-0x1afp-2") << '\n'
              << std::atof("inF") << '\n'
              << std::atof("Nan") << '\n'
              << std::atof("invalid") << '\n';
}

Ausgabe: 

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

Siehe auch

(C++11) (C++11) (C++11)
wandelt eine Zeichenkette in einen Gleitkommawert um
(Funktion)
wandelt eine Byte-Zeichenkette in einen Gleitkommawert um
(Funktion)
(C++17)
wandelt eine Zeichenfolge in einen Integer- oder Gleitkommawert um
(Funktion)
(C++11)
wandelt eine Byte-Zeichenkette in einen Integerwert um
(Funktion)
C-Dokumentation für atof