WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::to_string — eine Zahl in Text umwandeln

std::to_string aus <string> gibt die textuelle Darstellung einer Zahl als std::string zurück. Dieser Eintrag behandelt C++23, einschließlich Einschränkungen bei der Gleitkommaformatierung und des Unterschieds zum neueren Arbeitsentwurf.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <string>

std::string std::to_string(int val);
std::string std::to_string(unsigned val);
std::string std::to_string(long val);
std::string std::to_string(unsigned long val);
std::string std::to_string(long long val);
std::string std::to_string(unsigned long long val);
std::string std::to_string(float val);
std::string std::to_string(double val);
std::string std::to_string(long double val);

std::to_string(value) erstellt und gibt einen std::string mit der Darstellung einer Zahl zurück. Dafür ist <string> erforderlich; die Funktion gibt selbst nichts aus. Ihre Überladungen akzeptieren int, unsigned, long, unsigned long, long long, unsigned long long, float, double und long double. Ganzzahlen werden dezimal ausgegeben, negative Werte mit einem vorangestellten -.

In C++23 verhält sich die Umwandlung wie die entsprechende Formatierung durch sprintf. Endliche Gleitkommawerte verwenden die Festkommaschreibweise mit sechs Ziffern nach dem Dezimaltrennzeichen. Das Trennzeichen hängt von der globalen C-Locale ab. Kleine Werte können zu null gerundet werden. In der "C"-Locale kann std::to_string(1e-7) beim Runden zum nächstgelegenen Wert "0.000000" ergeben. Wenn sprintf den aktiven Rundungsmodus berücksichtigt, kann beim Runden nach oben stattdessen "0.000001" herauskommen. Betrachte diese Funktion nicht als verlustfreie Darstellung beliebiger Gleitkommazahlen.

Die Funktion bietet keine Argumente zur Auswahl einer Basis oder Genauigkeit. Wie im Beispiel kannst du den zurückgegebenen Text mit einem anderen std::string verketten. Die Funktion wandelt eine Zahl in Text um; sie parst keinen Text in eine Zahl.

Versionsumfang: Dieser Eintrag bezieht sich auf C++23 und entspricht damit dem Compiler-Flag des Repositorys; das Produktionslaufzeitverhalten ist nicht bestätigt. Der aktuelle Entwurf an den angegebenen Adressen legt das Ergebnis bereits als format("{}", val) fest und hält abweichende Gleitkommaergebnisse gegenüber C++23 fest. Übertrage dieses neuere Verhalten nicht auf C++23.

Beispiele

#include <iostream>
#include <string>

int main() {
    const std::string message = std::string("count=") + std::to_string(-42);
    std::cout << message << '\n';
}

Ergebnis

count=-42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen