WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::istringstream — Werte aus Text lesen

std::istringstream liest mit dem Operator >> Werte aus Text im Arbeitsspeicher. Dabei gelten dieselben Formatierungsregeln und Fehlerzustände wie bei anderen Eingabeströmen, ohne dass eine Datei geöffnet werden muss.

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

Syntax

#include <sstream>
std::istringstream input{"42 7"};
int value{};
while (input >> value) {
    // Use value.
}

std::istringstream, deklariert in <sstream>, ist ein Alias für std::basic_istringstream<char>. Er ermöglicht die Stream-Eingabe aus einem Textpuffer im Arbeitsspeicher. Er eignet sich, um eine Zeile in Wörter und Zahlen zu zerlegen; anders als std::ostringstream liest er Text, statt Ausgabetext zu erstellen.

Erzeuge den Stream aus Text und lies anschließend Werte mit >> aus. Standardmäßig überspringt die formatierte Extraktion führende Leerzeichen; beim Einlesen in std::string endet sie vor dem nächsten Leerzeichen. Die Interpretation von Zahlen hängt von der Locale des Streams ab. Das Beispiel wählt ausdrücklich std::locale::classic() und gibt Ada 42 gefolgt von einem Zeilenumbruch aus.

Prüfe das Ergebnis der Extraktion: if (input >> value) oder while (input >> value). Die Bedingung ist falsch, wenn failbit oder badbit gesetzt ist. eofbit allein bedeutet nicht, dass die Extraktion fehlgeschlagen ist: Der letzte Wert kann erfolgreich gelesen werden, während zugleich das Eingabeende erkannt wird. Steuere die Schleife nicht mit while (!input.eof()). Eine erfolgreiche Zahleneingabe beweist außerdem nicht, dass der gesamte Text verbraucht wurde: Nach dem Lesen einer Zahl aus "12x" bleibt das x im Puffer.

Um den Stream nach einem Fehler oder dem Eingabeende erneut zu verwenden, rufe input.clear(); input.str("10 20"); auf. clear() setzt die Zustandsflags zurück, entfernt aber keinen Text; str(...) ersetzt den Text, setzt diese Flags jedoch nicht zurück. Dieser Eintrag verwendet in C++23 verfügbare Funktionen; der angeführte Working Draft ist ein fortlaufend überarbeitetes Dokument und keine unveränderliche C++23-Spezifikation.

Beispiele

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

int main() {
    std::istringstream input{"Ada 17 25"};
    input.imbue(std::locale::classic());

    std::string name;
    int first{};
    int second{};
    if (!(input >> name >> first >> second)) {
        std::cout << "invalid input\n";
        return 1;
    }

    std::cout << name << ' ' << first + second << '\n';
}

Ergebnis

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