KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::ostringstream — tekst maken met een stream

std::ostringstream uit <sstream> formatteert waarden naar tekst die in het geheugen wordt opgeslagen. Je gebruikt de operator << zoals bij een uitvoerstream; met str() haal je het resultaat op als std::string.

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

Syntax

#include <sstream>

std::ostringstream out;
out << value;
std::string text = out.str();

std::ostringstream is een alias voor std::basic_ostringstream<char> uit <sstream>. Het is een uitvoerstream die naar een interne stringbuffer schrijft, en niet rechtstreeks naar een terminal of bestand. Je kunt er berichten mee samenstellen uit strings en getallen. std::istringstream leest tekst in, terwijl std::stringstream beide richtingen ondersteunt.

Voeg waarden in met <<. Manipulatoren zoals std::fixed en std::setprecision(2) bepalen de opmaak; samen vragen ze om twee cijfers na het decimaalteken. De getalnotatie hangt af van de locale van de stream. Het voorbeeld stelt expliciet std::locale::classic() in om een decimaalpunt te krijgen.

De aanroep out.str() op een benoemde stream geeft een kopie van de verzamelde tekst terug als std::string; de buffer wordt niet leeggemaakt. Vervang de inhoud met out.str(std::string{}); om de stream opnieuw te gebruiken. Afzonderlijk zet out.clear(); de foutstatusvlaggen terug, niet de tekst. Geen van beide bewerkingen herstelt de standaardopmaakinstellingen.

Het voorbeeld gebruikt interfaces die beschikbaar zijn in C++23. Het meegeleverde document is een evoluerend werkdocument en kan ook latere toevoegingen bevatten. De compileroptie van de repository bevestigt niet welke runtimeomgeving in productie wordt gebruikt.

Voorbeelden

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

int main() {
    std::ostringstream out;
    out.imbue(std::locale::classic());
    out << "items=" << 3 << "; price="
        << std::fixed << std::setprecision(2) << 12.5;

    const std::string text = out.str();
    std::cout << text << '\n';
}

Resultaat

items=3; price=12.50

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