std::to_chars_result
Von cppreference.com
| Definiert in Header <charconv> |
||
| struct to_chars_result; |
(seit C++17) | |
std::to_chars_result ist der Rückgabetyp von std::to_chars. Es hat keine Basisklassen und nur die folgenden Member.
Inhalt |
[bearbeiten] Datenelemente
| Member-Name | Definition |
| ptr |
ein Zeiger vom Typ char* (öffentliches Mitgliedsobjekt) |
| ec |
ein Fehlercode vom Typ std::errc (öffentliches Mitgliedsobjekt) |
[bearbeiten] Member- und Friend-Funktionen
operator==(std::to_chars_result)
| friend bool operator==( const to_chars_result&, const to_chars_result& ) = default; |
(seit C++20) | |
Vergleicht die beiden Argumente mittels Standardvergleich (der operator== zum Vergleichen von ptr bzw. ec verwendet).
Diese Funktion ist für gewöhnliche unqualifizierte oder qualifizierte Suchen nicht sichtbar und kann nur durch Argument-abhängige Suche gefunden werden, wenn std::to_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 zurück ec == std::errc{}.
[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 <array> #include <charconv> #include <iostream> #include <string_view> #include <system_error> void show_to_chars(auto... format_args) { std::array<char, 10> str; #if __cpp_lib_to_chars >= 202306L and __cpp_structured_bindings >= 202406L // use C++26 structured bindings declaration as condition (P0963) // and C++26 to_chars_result::operator bool() for error checking (P2497) if (auto [ptr, ec] = std::to_chars(str.data(), str.data() + str.size(), format_args...)) std::cout << std::string_view(str.data(), ptr) << '\n'; else std::cout << std::make_error_code(ec).message() << '\n'; #elif __cpp_lib_to_chars >= 202306L // use C++26 to_chars_result::operator bool() for error checking (P2497) if (auto result = std::to_chars(str.data(), str.data() + str.size(), format_args...)) std::cout << std::string_view(str.data(), result.ptr) << '\n'; else std::cout << std::make_error_code(result.ec).message() << '\n'; #else // fallback to C++17 if-with-initializer and structured bindings if (auto [ptr, ec] = std::to_chars(str.data(), str.data() + str.size(), format_args...); ec == std::errc()) std::cout << std::string_view(str.data(), ptr - str.data()) << '\n'; else std::cout << std::make_error_code(ec).message() << '\n'; #endif } int main() { show_to_chars(42); show_to_chars(+3.14159F); show_to_chars(-3.14159, std::chars_format::fixed); show_to_chars(-3.14159, std::chars_format::scientific, 3); show_to_chars(3.1415926535, std::chars_format::fixed, 10); }
Mögliche Ausgabe
42 3.14159 -3.14159 -3.142e+00 Value too large for defined data type
[bearbeiten] Siehe auch
| (C++17) |
konvertiert einen Ganzzahl- oder Gleitkommawert in eine Zeichensequenz (Funktion) |
