KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::stringstream — tekst in het geheugen lezen en schrijven

std::stringstream uit <sstream> formatteert waarden als tekst en leest waarden uit tekst die in het geheugen wordt bewaard. Het combineert de operatoren << en >> met een tekenreeksbuffer en de foutstatus van de stream.

Versie: 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 uit <sstream> is een alias voor std::basic_stringstream<char>. De stream bewaart tekst in het geheugen en ondersteunt standaard zowel lezen als schrijven. std::istringstream is bedoeld om te lezen; std::ostringstream is bedoeld om te schrijven.

De operator << formatteert waarden in de buffer en >> leest waarden in variabelen. Geformatteerde extractie slaat standaard voorafgaande witruimte over; extractie naar een std::string stopt vóór het volgende witruimteteken. De getalnotatie hangt af van de locale van de stream; het voorbeeld stelt std::locale::classic() in.

Voor een benoemde stream geeft stream.str() een kopie van de tekst terug, inclusief delen die al zijn gelezen. De lees- en schrijfposities zijn gescheiden: schrijven verplaatst de leespositie niet. Ga er echter niet van uit dat elke volgende schrijfactie tekst aan het einde toevoegt; dat hangt af van de schrijfpositie en de openingsmodus.

Controleer of de bewerking slaagt met if (stream >> value). Een mislukte conversie kan failbit instellen, en het bereiken van het einde van de invoer kan eofbit instellen. Roep stream.clear(); stream.str("new text"); aan om de stream met nieuwe tekst opnieuw te gebruiken. clear() reset de statusvlaggen, maar verwijdert geen tekst en spoelt de stream niet terug; str(...) vervangt de tekst, maar reset de foutvlaggen niet.

Voorbeelden

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

Resultaat

Ada
Ada 42

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen