Namespaces
Variants

    std::to_string

    Von de.cppreference.net
     
    C++
     
    Zeichenkettenbibliothek
     
    std::basic_string
     
    Definiert in Header <string> 
    std::string to_string( int value );
    		(1) (seit C++11) 
    std::string to_string( long value );
    		(2) (seit C++11) 
    std::string to_string( long long value );
    		(3) (seit C++11) 
    std::string to_string( unsigned value );
    		(4) (seit C++11) 
    std::string to_string( unsigned long value );
    		(5) (seit C++11) 
    std::string to_string( unsigned long long value );
    		(6) (seit C++11) 
    std::string to_string( float value );
    		(7) (seit C++11) 
    std::string to_string( double value );
    		(8) (seit C++11) 
    std::string to_string( long double value );
    		(9) (seit C++11)

    Konvertiert einen numerischen Wert in std::string.

    Es sei buf ein interner Puffer der Konvertierungsfunktionen, der groß genug ist, um das Ergebnis der Konvertierung aufzunehmen.

    1) Konvertiert eine vorzeichenbehaftete Ganzzahl in einen String, wie durch std::sprintf(buf, "%d", value).
    2) Konvertiert eine vorzeichenbehaftete Ganzzahl in einen String, wie durch std::sprintf(buf, "%ld", value).
    3) Konvertiert eine vorzeichenbehaftete Ganzzahl in einen String, wie durch std::sprintf(buf, "%lld", value).
    4) Konvertiert eine vorzeichenlose Ganzzahl in einen String, wie durch std::sprintf(buf, "%u", value).
    5) Konvertiert eine vorzeichenlose Ganzzahl in einen String, wie durch std::sprintf(buf, "%lu", value).
    6) Konvertiert eine vorzeichenlose Ganzzahl in einen String, wie durch std::sprintf(buf, "%llu", value).
    7,8) Konvertiert einen Gleitkommawert in einen String, wie durch std::sprintf(buf, "%f", value).
    9) Konvertiert einen Gleitkommawert in einen String, wie durch std::sprintf(buf, "%Lf", value).
    		(bis C++26)
    1-9) Konvertiert einen numerischen Wert in einen String, wie durch std::format("{}", value).
    		(seit C++26)

    Parameter

    value - ein numerischer Wert zur Konvertierung

    Rückgabewert

    Ein String, der den konvertierten Wert enthält.

    Ausnahmen

    Kann std::bad_alloc vom std::string Konstruktor werfen.

    Hinweise

    • Bei Fließkommatypen kann std::to_string unerwartete Ergebnisse liefern, da die Anzahl der signifikanten Stellen im zurückgegebenen String null sein kann, siehe Beispiel.
    • Der Rückgabewert kann erheblich von der Standardausgabe von std::cout abweichen, siehe Beispiel.
    • std::to_string verlässt sich auf die aktuelle C-Locale für Formatierungszwecke, und daher können gleichzeitige Aufrufe von std::to_string aus mehreren Threads zu einer teilweisen Serialisierung von Aufrufen führen.
      • Die Ergebnisse der Überladungen für Ganzzahltypen verlassen sich nicht auf die aktuelle C-Locale, und daher vermeiden Implementierungen generell den Zugriff auf die aktuelle C-Locale in diesen Überladungen sowohl für Korrektheit als auch Leistung. Allerdings ist eine solche Vermeidung durch den Standard nicht garantiert.
    		(bis C++26)

    C++17 bietet std::to_chars als leistungsstärkere, gebietsschemaunabhängige Alternative.

    Feature-Test Makro Wert Std Funktion
    __cpp_lib_to_string 202306L (C++26) Neudefinition von std::to_string basierend auf std::format

    Beispiel

    Diesen Code ausführen 
    #include <cstdio>
#include <format>
#include <initializer_list>
#include <iostream>
#include <string>
#if __cpp_lib_to_string >= 202306L
constexpr auto revision() { return " (post C++26)"; }
#else
constexpr auto revision() { return " (pre C++26)"; }
#endif
int main()
{
    for (const double f : {1.23456789555555, 23.43, 1e-9, 1e40, 1e-40, 123456789.0})
    {
        std::cout << "to_string:\t" << std::to_string(f) << revision() << '\n';
        // Vor C++26 entspricht die Ausgabe von std::to_string std::printf.
        std::printf("printf:\t\t%f\n", f);
        // Ab C++26 entspricht die Ausgabe von std::to_string std::format.
        std::cout << std::format("format:\t\t{}\n", f);
        std::cout << "std::cout:\t" << f << "\n\n";
    }
}

    Mögliche Ausgabe: 

    to_string:      1.234568 (pre C++26)
printf:         1.234568
format:         1.23456789555555
std::cout:      1.23457
to_string:      23.430000 (pre C++26)
printf:         23.430000
format:         23.43
std::cout:      23.43
to_string:      0.000000 (pre C++26)
printf:         0.000000
format:         1e-09
std::cout:      1e-09
to_string:      10000000000000000303786028427003666890752.000000 (pre C++26)
printf:         10000000000000000303786028427003666890752.000000
format:         1e+40
std::cout:      1e+40
to_string:      0.000000 (pre C++26)
printf:         0.000000
format:         1e-40
std::cout:      1e-40
to_string:      123456789.000000 (pre C++26)
printf:         123456789.000000
format:         123456789
std::cout:      1.23457e+08

    Siehe auch

    (C++11)
    		wandelt einen ganzzahligen oder Gleitkommawert in wstring um
    (Funktion)
    (C++11) (C++11)
    		wandelt eine Zeichenkette in eine vorzeichenlose Ganzzahl um
    (Funktion)
    (C++11) (C++11) (C++11)
    		wandelt eine Zeichenkette in eine vorzeichenbehaftete Ganzzahl um
    (Funktion)
    (C++11) (C++11) (C++11)
    		wandelt eine Zeichenkette in einen Gleitkommawert um
    (Funktion)
    (C++17)
    		wandelt einen ganzzahligen oder Gleitkommawert in eine Zeichenfolge um
    (Funktion)