WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen