std::stof, std::stod, std::stold

float       stof ( const std::string& str, std::size_t* pos = nullptr );

float       stof ( const std::wstring& str, std::size_t* pos = nullptr );

double      stod ( const std::string& str, std::size_t* pos = nullptr );

double      stod ( const std::wstring& str, std::size_t* pos = nullptr );

long double stold( const std::string& str, std::size_t* pos = nullptr );

long double stold( const std::wstring& str, std::size_t* pos = nullptr );

Interpretiert einen Gleitkommawert in einer Zeichenkette str.

Sei ptr ein interner (für die Konvertierungsfunktionen) Zeiger vom Typ char* (1,3,5) oder wchar_t* (2,4,6), entsprechend.

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

• Dezimaler Gleitkommaausdruck. Er besteht aus den folgenden Teilen:

• (optional) Plus- oder Minuszeichen
• Nichtleere Folge von Dezimalziffern, die optional ein Dezimaltrennzeichen enthalten kann (wie durch das aktuelle C Locale bestimmt) (definiert die Mantisse)
• (optional) e oder E gefolgt von optionalem Minus- oder Pluszeichen und einer nichtleeren Folge von Dezimalziffern (definiert den Exponenten zur Basis 10)

• Hexadezimaler Gleitkommaausdruck. Er besteht aus den folgenden Teilen:

• (optional) Plus- oder Minuszeichen
• 0x oder 0X
• Nichtleere Folge von Hexadezimalziffern, die optional ein Dezimaltrennzeichen enthalten kann (wie durch das aktuelle C Locale bestimmt) (definiert die Mantisse)
• (optional) p oder P gefolgt von optionalem Minus- oder Pluszeichen und einer nichtleeren Folge von Dezimalziffern (definiert den Exponenten zur Basis 2)

• Unendlichkeitsausdruck. Er besteht aus den folgenden Teilen:

• (optional) Plus- oder Minuszeichen
• INF oder INFINITY Groß-/Kleinschreibung ignorierend

• Keine-Zahl-Ausdruck (NaN). Er besteht aus den folgenden Teilen:

• (optional) Plus- oder Minuszeichen
• NAN oder NAN(char_sequence ) Groß-/Kleinschreibung des NAN Teils ignorierend. char_sequence darf nur Ziffern, lateinische Buchstaben und Unterstriche enthalten. Das Ergebnis ist ein stiller NaN-Gleitkommawert.

• jeder andere Ausdruck, der vom aktuell installierten C Locale akzeptiert werden könnte.

Wenn pos kein Nullzeiger ist, erhält ptr die Adresse des ersten nicht konvertierten Zeichens in str.c_str(), und der Index dieses Zeichens wird berechnet und in *pos gespeichert, was die Anzahl der Zeichen angibt, die von der Konvertierung verarbeitet wurden.

Parameter

Rückgabewert

Der in den angegebenen Gleitkommatyp konvertierte String.

Ausnahmen

std::invalid_argument falls keine Konvertierung durchgeführt werden konnte.

std::out_of_range falls der konvertierte Wert außerhalb des Bereichs des Ergebnistyps liegen würde oder wenn die zugrunde liegende Funktion ( std::strtof , std::strtod oder std::strtold ) errno auf ERANGE setzt.

Beispiel

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch