WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::stringstream — Text im Speicher lesen und schreiben

std::stringstream aus <sstream> formatiert Werte als Text und liest Werte aus im Speicher gehaltenem Text. Der Stream verbindet die Operatoren << und >> mit einem Zeichenkettenpuffer und einem Fehlerzustand.

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

Syntax

#include <sstream>
std::stringstream stream;
stream << value;
stream >> variable;
std::string text = stream.str();

std::stringstream aus <sstream> ist ein Alias für std::basic_stringstream<char>. Er hält Text im Speicher und unterstützt standardmäßig sowohl Lesen als auch Schreiben. std::istringstream dient zum Lesen, std::ostringstream zum Schreiben.

Der Operator << formatiert Werte in den Puffer, und >> liest Werte in Variablen ein. Formatierte Eingaben überspringen standardmäßig führende Leerzeichen; das Einlesen in std::string endet vor dem nächsten Leerzeichen. Die Zahlenformatierung hängt von der Locale des Streams ab; das Beispiel setzt std::locale::classic().

Bei einem benannten Stream gibt stream.str() eine Kopie des Textes zurück, einschließlich bereits gelesener Teile. Lese- und Schreibposition sind getrennt: Schreiben verschiebt die Leseposition nicht. Gehe jedoch nicht davon aus, dass jeder weitere Schreibvorgang am Ende anhängt; das hängt von der Schreibposition und dem Öffnungsmodus ab.

Prüfe den Erfolg mit if (stream >> value). Eine fehlgeschlagene Konvertierung kann failbit setzen, und das Erreichen des Eingabeendes kann eofbit setzen. Um den Stream mit neuem Text wiederzuverwenden, rufe stream.clear(); stream.str("new text"); auf. clear() setzt die Statusflags zurück, entfernt aber weder Text noch setzt es den Stream zurück; str(...) ersetzt den Text, setzt jedoch keine Fehlerflags zurück.

Beispiele

#include <iostream>
#include <locale>
#include <sstream>
#include <string>

int main() {
    std::stringstream stream;
    stream.imbue(std::locale::classic());
    stream << "Ada " << 42;

    std::string name;
    int score = 0;
    if (stream >> name >> score) {
        std::cout << name << '\n';
        std::cout << stream.str() << '\n';
    } else {
        return 1;
    }
}

Ergebnis

Ada
Ada 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