std::from_chars_result
Von cppreference.com
| Definiert in Header <charconv> |
||
| struct from_chars_result; |
(seit C++17) | |
std::from_chars_result ist der Rückgabetyp von std::from_chars. Sie hat keine Basisklassen und nur die folgenden Member.
Inhalt |
[bearbeiten] Datenmember
| Member-Name | Definition |
| ptr |
ein Zeiger vom Typ const char* (öffentliches Mitgliedsobjekt) |
| ec |
ein Fehlercode vom Typ std::errc (öffentliches Mitgliedsobjekt) |
[bearbeiten] Member- und Friend-Funktionen
operator==(std::from_chars_result)
| friend bool operator==( const from_chars_result&, const from_chars_result& ) = default; |
(seit C++20) | |
Vergleicht die beiden Argumente mittels Standardvergleiche (welche operator== zum Vergleichen von ptr und ec jeweils verwenden).
Diese Funktion ist für gewöhnliche nicht-qualifizierte oder qualifizierte Suche nicht sichtbar und kann nur durch Argumentabhängige Suche gefunden werden, wenn std::from_chars_result eine assoziierte Klasse der Argumente ist.
Der Operator != wird aus operator== synthetisiert.
operator bool
| constexpr explicit operator bool() const noexcept; |
(seit C++26) | |
Prüft, ob die Konvertierung erfolgreich war. Gibt ec == std::errc{} zurück.
[bearbeiten] Hinweise
| Feature-Test-Makro | Wert | Std | Feature |
|---|---|---|---|
__cpp_lib_to_chars |
201611L |
(C++17) | Elementare String-Konvertierungen (std::to_chars, std::from_chars) |
202306L |
(C++26) | Testen des Erfolgs oder Misserfolgs von <charconv>-Funktionen |
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#include <cassert> #include <charconv> #include <iomanip> #include <iostream> #include <optional> #include <string_view> #include <system_error> int main() { for (std::string_view const str : {"1234", "15 foo", "bar", " 42", "5000000000"}) { std::cout << "String: " << std::quoted(str) << ". "; int result{}; auto [ptr, ec] = std::from_chars(str.data(), str.data() + str.size(), result); if (ec == std::errc()) std::cout << "Result: " << result << ", ptr -> " << std::quoted(ptr) << '\n'; else if (ec == std::errc::invalid_argument) std::cout << "This is not a number.\n"; else if (ec == std::errc::result_out_of_range) std::cout << "This number is larger than an int.\n"; } // C++23's constexpr from_char demo / C++26's operator bool() demo: auto to_int = [](std::string_view s) -> std::optional<int> { int value{}; #if __cpp_lib_to_chars >= 202306L if (std::from_chars(s.data(), s.data() + s.size(), value)) #else if (std::from_chars(s.data(), s.data() + s.size(), value).ec == std::errc{}) #endif return value; else return std::nullopt; }; assert(to_int("42") == 42); assert(to_int("foo") == std::nullopt); #if __cpp_lib_constexpr_charconv and __cpp_lib_optional >= 202106 static_assert(to_int("42") == 42); static_assert(to_int("foo") == std::nullopt); #endif }
Ausgabe
String: "1234". Result: 1234, ptr -> "" String: "15 foo". Result: 15, ptr -> " foo" String: "bar". This is not a number. String: " 42". This is not a number. String: "5000000000". This number is larger than an int.
[bearbeiten] Siehe auch
| (C++17) |
konvertiert eine Zeichensequenz in einen Ganzzahl- oder Gleitkommawert (Funktion) |
