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

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Bibliothek für Zeichenketten

Klassen

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Memberfunktionen basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator Elementzugriff basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) Iteratoren basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Suche basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of

Modifizierer basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap Kapazität basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) Operationen basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

Konstanten basic_string::npos Nicht-Member-Funktionen operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline Vergleich operator==operator!=operator<operator>operator<=operator>=operator<=> (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)(C++20) Numerische Konvertierungen stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Literale operator""s (C++14) Hilfsklassen hash<std::basic_string> (C++11) Deduction guides (C++17)

 

Definiert in Header <string>
float       stof ( const std::string& str, std::size_t* pos = nullptr );	(1)	(seit C++11)
float       stof ( const std::wstring& str, std::size_t* pos = nullptr );	(2)	(seit C++11)
double      stod ( const std::string& str, std::size_t* pos = nullptr );	(3)	(seit C++11)
double      stod ( const std::wstring& str, std::size_t* pos = nullptr );	(4)	(seit C++11)
long double stold( const std::string& str, std::size_t* pos = nullptr );	(5)	(seit C++11)
long double stold( const std::wstring& str, std::size_t* pos = nullptr );	(6)	(seit C++11)

Interpretiert einen Fließkommawert in einem String str.

Sei ptr ein interner (innerhalb der Konvertierungsfunktionen) Zeiger vom Typ char* (1,3,5) oder wchar_t* (2,4,6), je nach Fall.

1) Ruft std::strtof(str.c_str(), &ptr) auf.

2) Ruft std::wcstof(str.c_str(), &ptr) auf.

3) Ruft std::strtod(str.c_str(), &ptr) auf.

4) Ruft std::wcstod(str.c_str(), &ptr) auf.

5) Ruft std::strtold(str.c_str(), &ptr) auf.

6) Ruft std::wcstold(str.c_str(), &ptr) auf.

Die Funktion verwirft beliebige Leerzeichen (wie von 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 sie in einen Gleitkommawert. Der gültige Gleitkommawert kann einer der folgenden sein:

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

• (optional) Vorzeichen (+ oder -)
• Nichtleere Sequenz von Dezimalziffern, die optional ein Dezimaltrennzeichen enthält (wie von der aktuellen C Locale bestimmt) (definiert den Significand)
• (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
• Nichtleere Sequenz von Hexadezimalziffern, die optional ein Dezimaltrennzeichen enthält (wie von der aktuellen C Locale bestimmt) (definiert den Significand)
• (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.

• Andere Ausdrücke, die von der aktuell installierten C Locale akzeptiert werden könnten.

Wenn pos kein Nullzeiger ist, empfängt 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 vom Konvertierungsprozess verarbeiteten Zeichen angibt.

Parameter

str	-	der zu konvertierende String
pos	-	Adresse eines Integers, um die Anzahl der verarbeiteten Zeichen zu speichern

Rückgabewert

Der in den angegebenen Fließkommatyp konvertierte String.

Ausnahmen

std::invalid_argument, wenn keine Konvertierung durchgeführt werden konnte.

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

Fehlerberichte

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

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 2009	C++11	std::out_of_range würde nicht ausgelöst, wenn der konvertierte Wert außerhalb des Bereichs des Ergebnistyps liegen würde	wirft
LWG 2403	C++11	stof rief std::strtod oder std::wcstod auf	stof ruft std::strtof oder std::wcstof auf

Siehe auch

stoistolstoll (C++11)(C++11)(C++11)	konvertiert einen String in eine vorzeichenbehaftete Ganzzahl (function)
stoulstoull (C++11)(C++11)	konvertiert einen String in eine vorzeichenlose Ganzzahl (function)
from_chars (C++17)	konvertiert eine Zeichensequenz in einen Ganzzahl- oder Gleitkommawert (Funktion)