Namespaces
Variants

std:: to_string

From cppreference.net
C++
Strings library
std::basic_string
Definiert im 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 .

Sei buf ein interner Puffer der Konvertierungsfunktionen, der groß genug ist, um das Ergebnis der Konvertierung zu enthalten.

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

Inhaltsverzeichnis

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)