CKTIS / C++
std::ostringstream — Text mit einem Stream erstellen
std::ostringstream aus <sstream> formatiert Werte zu Text, der im Arbeitsspeicher gespeichert wird. Mit dem Operator << wie bei einem Ausgabestream werden Werte eingefügt; str() liefert das Ergebnis als std::string zurück.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <sstream>
std::ostringstream out;
out << value;
std::string text = out.str();std::ostringstream ist ein Alias für std::basic_ostringstream<char> aus <sstream>. Der Ausgabestream schreibt in einen internen String-Puffer statt direkt in ein Terminal oder eine Datei. Er eignet sich, um Nachrichten aus Zeichenfolgen und Zahlen zusammenzusetzen. std::istringstream liest Text ein, während std::stringstream beide Richtungen unterstützt.
Füge Werte mit << ein. Manipulatoren wie std::fixed und std::setprecision(2) steuern die Formatierung; zusammen fordern sie zwei Ziffern nach dem Dezimaltrennzeichen an. Die Zahlenformatierung hängt von der Locale des Streams ab. Das Beispiel setzt ausdrücklich std::locale::classic(), um einen Dezimalpunkt zu erhalten.
Der Aufruf out.str() für einen benannten Stream gibt eine Kopie des gesammelten Textes als std::string zurück; der Puffer wird dadurch nicht geleert. Um den Stream wiederzuverwenden, ersetze seinen Inhalt mit out.str(std::string{});. Separat setzt out.clear(); die Fehlerflags zurück, nicht den Text. Keine dieser Operationen stellt die Standard-Formatierungseinstellungen wieder her.
Das Beispiel verwendet Schnittstellen, die in C++23 verfügbar sind. Das bereitgestellte Dokument ist ein fortlaufend bearbeiteter Standardentwurf und kann auch spätere Ergänzungen enthalten. Die Compiler-Option des Repositorys bestätigt nicht die Produktionslaufzeitumgebung.
Beispiele
#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>
#include <string>
int main() {
std::ostringstream out;
out.imbue(std::locale::classic());
out << "items=" << 3 << "; price="
<< std::fixed << std::setprecision(2) << 12.5;
const std::string text = out.str();
std::cout << text << '\n';
}
Ergebnis
items=3; price=12.50
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.