Strumienie napisów w C++: stringstream do parsowania i budowania

Strumień, który mieszka w napisie

Znasz już cin i cout: strumienie podłączone do klawiatury i ekranu. Strumień napisu to ta sama idea, tylko dane mieszkają w std::string w pamięci. Piszesz do niego przez << i wyciągasz wartości przez >>, dokładnie jak przy strumieniach konsoli, ale nic nie trafia do terminala.

Ta jedna idea rozwiązuje dwa codzienne problemy: parsowanie tekstu na wartości określonych typów i budowanie sformatowanego napisu z różnych kawałków. Wszystko znajduje się w nagłówku <sstream> i występuje w trzech odmianach:

• istringstream: tylko do odczytu, do parsowania wejścia.
• ostringstream: tylko do zapisu, do budowania wyjścia.
• stringstream: w obu kierunkach.

#include <iostream>
#include <sstream>
#include <string>
using namespace std;

int main() {
    stringstream ss;
    ss << "score: " << 42 << ", level: " << 7;

    cout << ss.str() << "\n";   // wyciągnij cały bufor z powrotem jako napis
}

ss.str() zwraca wszystko, co do tej pory zapisano, jako zwykły string. Operatory << wykonały to samo formatowanie int na tekst co cout, tylko wynik został przechwycony, a nie wypisany.

Parsowanie: wyciąganie wartości określonych typów

Prawdziwa moc ujawnia się przy >>. Daj strumieniowi trochę tekstu, a wyodrębnianie zamieni każdy token na typ, o który prosisz, pomijając białe znaki między nimi. To czysty sposób na rozbicie jednej linii na kilka pól o określonych typach:

#include <iostream>
#include <sstream>
#include <string>
using namespace std;

int main() {
    string line = "Ada 36 5.5";
    istringstream iss(line);

    string name;
    int age;
    double rating;
    iss >> name >> age >> rating;   // każde >> bierze kolejny token oddzielony białymi znakami

    cout << name << " is " << age << " (rated " << rating << ")\n";
}

Każde >> czyta do następnego białego znaku i konwertuje: "Ada" na string, "36" na int, "5.5" na double. Zwróć uwagę na istringstream: typ tylko do odczytu jasno pokazuje, że wyłącznie parsujesz.

Bezpieczna konwersja napisów na liczby

Częste zadanie to zamiana pojedynczego napisu, takiego jak "42", na int. stringstream to potrafi i mówi, czy tekst był w ogóle poprawną liczbą, czego atoi nigdy nie robi:

#include <iostream>
#include <sstream>
#include <string>
using namespace std;

int main() {
    string text = "123abc";

    stringstream ss(text);
    int value;
    if (ss >> value) {
        cout << "Parsed: " << value << "\n";
    } else {
        cout << "Not a valid number\n";
    }

    cout << "Got " << value << " from \"" << text << "\"\n";
}

Tutaj ss >> value czyta 123, zatrzymuje się na a i kończy się sukcesem, więc jeśli to ważne, zawsze sprawdzaj cały napis. Solidne sprawdzenie polega na wczytaniu liczby i upewnieniu się, że nie zostało nic istotnego. Przy prostych konwersjach pojedynczej wartości std::stoi, std::stod i pokrewne są krótsze; po stringstream sięgaj, gdy jeden napis niesie kilka różnych wartości.

Dzielenie napisu według separatora

Dzielenie tekstu to najczęściej wyszukiwane zadanie ze strumieniami napisów. Połącz strumień z std::getline, które potrafi czytać do dowolnego znaku separatora, a nie tylko do znaku nowej linii:

#include <iostream>
#include <sstream>
#include <string>
#include <vector>
using namespace std;

int main() {
    string csv = "red,green,blue,yellow";
    stringstream ss(csv);

    vector<string> parts;
    string token;
    while (getline(ss, token, ',')) {   // trzeci argument to separator
        parts.push_back(token);
    }

    for (const string& p : parts) cout << "[" << p << "] ";
    cout << "\n";
}

Wzorzec while (getline(...)) wykonuje pętlę, dopóki strumień nie wyschnie, bo getline zwraca strumień, a strumień daje false, gdy nic już nie zostało. Każdy token trafia do wektora, naturalnego miejsca na zbieranie zmiennej liczby kawałków. Pomiń trzeci argument, a zamiast tego podzielisz tekst na tokeny po białych znakach przez >>: wybierz separator, którego używają twoje dane.

Budowanie napisów w pamięci

W drugą stronę ostringstream składa sformatowany napis bez ryzyka przepełnienia bufora jak przy sprintf i bez kruchego ręcznego łączenia. Idealnie nadaje się do linii logów, nazw plików czy komunikatów zszytych z liczb i tekstu:

#include <iostream>
#include <iomanip>
#include <sstream>
#include <string>
using namespace std;

int main() {
    int day = 5, month = 6, year = 2026;

    ostringstream oss;
    oss << year << "-"
        << setw(2) << setfill('0') << month << "-"
        << setw(2) << setfill('0') << day;

    string filename = "backup_" + oss.str() + ".zip";
    cout << filename << "\n";   // backup_2026-06-05.zip
}

Całe formatowanie z <iomanip>, którego używasz z cout, czyli setw, setfill, setprecision, hex, działa identycznie na strumieniu napisu, więc wynik z dopełnieniem, o stałej szerokości albo szesnastkowy trafia prosto do string.

Pułapka: zresetuj przed ponownym użyciem

Pułapka, na którą trafia każdy, to ponowne użycie strumienia bez resetu. Gdy strumień dojdzie do końca danych, jego flagi eof i fail pozostają ustawione, a każde kolejne >> po cichu nic nie robi: żadnego błędu, tylko nieaktualne wartości:

stringstream ss("10");
int a, b;
ss >> a;            // a = 10, strumień jest na końcu -> flaga eof ustawiona
ss.str("20");       // wczytaj nowy tekst...
ss >> b;            // PO CICHU SIĘ NIE UDAJE: flagi błędu są nadal ustawione, b bez zmian

Musisz wyczyścić stan błędu i zawartość. Właściwa kolejność to najpierw clear(), potem str():

#include <iostream>
#include <sstream>
using namespace std;

int main() {
    stringstream ss("10");
    int a, b;
    ss >> a;

    ss.clear();      // wyczyść flagi eof/fail
    ss.str("20");    // podmień bufor
    ss >> b;

    cout << a << " " << b << "\n";   // 10 20
}

Dwa pokrewne błędy: ss.clear() czyści flagi, ale nie opróżnia bufora (do tego służy ss.str("")), a stringstream, do którego ciągle dopisujesz przez <<, będzie rósł bez końca. Twórz nowy strumień wewnątrz pętli, zamiast używać tego samego, zabrudzonego w każdej iteracji.

Dalej: tablice

Strumienie napisów dają czysty sposób zamiany tekstu na wartości określonych typów i z powrotem, często na całą listę takich wartości, jak vector wypełniany przy dzieleniu CSV. Aby przechowywać i indeksować stałe kolekcje takich wartości, potrzebujesz najbardziej podstawowego kontenera w języku. Dalej omówimy tablice: jak je deklarować, indeksować, przechodzić po nich pętlą i omijać dostęp poza zakresem, który powoduje tyle niezdefiniowanego zachowania w C++.