Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::stringstream — odczyt i zapis tekstu w pamięci

std::stringstream z nagłówka <sstream> pozwala formatować wartości jako tekst i odczytywać wartości z tekstu w pamięci. Łączy operatory << i >> z buforem łańcuchowym oraz stanem błędów strumienia.

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

Składnia

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

std::stringstream z nagłówka <sstream> jest aliasem std::basic_stringstream<char>. Przechowuje tekst w pamięci i domyślnie obsługuje zarówno odczyt, jak i zapis. std::istringstream służy do odczytu, a std::ostringstream do zapisu.

Operator << formatuje wartości do bufora, a >> odczytuje wartości do zmiennych. Formatowany odczyt domyślnie pomija początkowe białe znaki; odczyt do std::string kończy się przed kolejnym białym znakiem. Formatowanie liczb zależy od ustawień regionalnych strumienia; przykład ustawia std::locale::classic().

Dla nazwanego strumienia stream.str() zwraca kopię tekstu, także części już odczytanej. Pozycje odczytu i zapisu są oddzielne: zapis nie przesuwa pozycji odczytu. Nie zakładaj jednak, że każdy kolejny zapis dopisuje na końcu; zależy to od pozycji zapisu i trybu otwarcia.

Sprawdzaj powodzenie przez if (stream >> value). Nieudana konwersja może ustawić failbit, a dojście do końca danych — eofbit. Aby ponownie użyć strumienia z nowym tekstem, wywołaj stream.clear(); stream.str("new text");. clear() resetuje flagi stanu, ale nie usuwa tekstu ani nie przewija strumienia; str(...) zastępuje tekst, ale nie resetuje flag błędów.

Przykłady

#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;
    }
}

Wynik

Ada
Ada 42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła