KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::ostream en std::basic_ostream — uitvoerstreams

std::basic_ostream is een uitvoerstreamsjabloon en std::ostream is de alias ervan voor char. Hiermee kun je waarden formatteren met operator<< en tekens naar een bijbehorende streambuffer schrijven.

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

Syntax

#include <ostream>
std::basic_ostream<CharT, Traits>
std::ostream // std::basic_ostream<char, std::char_traits<char>>
std::ostream& write_value(std::ostream& out, int value);

std::basic_ostream<CharT, Traits> uit <ostream> biedt een interface voor uitvoer naar een streambuffer. CharT bepaalt het tekentype, terwijl Traits de tekenbewerkingen levert; de standaardwaarde is std::char_traits<CharT>. std::ostream is precies een alias voor std::basic_ostream<char>, geen afzonderlijk sjabloon of uitvoerobject.

operator<< formatteert waarden zoals getallen. Invoegbewerkingen geven een verwijzing naar de stream terug, zodat aanroepen aan elkaar kunnen worden gekoppeld. put(c) schrijft één teken, terwijl write(s, n) n tekens ongeformatteerd schrijft, tenzij de uitvoer mislukt. flush() vraagt om synchronisatie van de bijbehorende buffer; dit garandeert geen duurzame opslag op schijf.

Accepteer std::ostream&, zodat een functie de doorgegeven stream kan gebruiken zonder deze te kopiëren. In het voorbeeld ontvangt write_value std::cout en geeft dezelfde stream terug; daarna voegt put('\n') een nieuweregelteken toe. Een losse \n vraagt niet om het leegmaken van de buffer; het voorbeeld roept flush() expliciet aan.

Uitvoerfouten worden gemeld via de streamstatus, onder meer met failbit of badbit; de uitzonderingsmaskerinstelling kan ervoor zorgen dat een uitzondering wordt gegenereerd. Ga er niet van uit dat het uitblijven van een uitzondering succes betekent: controleer de status, zoals de laatste voorwaarde van het voorbeeld doet. Dit artikel richt zich op C++23; de opgegeven compilatiestandaard bevestigt geen productie-runtimeomgeving. De bronnen geven een evoluerend concept van de standaard weer.

Voorbeelden

#include <iostream>
#include <locale>
#include <ostream>

std::ostream& write_value(std::ostream& out, int value) {
    return out << "value=" << value;
}

int main() {
    std::cout.imbue(std::locale::classic());
    write_value(std::cout, 42).put('\n');
    std::cout.flush();
    return std::cout ? 0 : 1;
}

Resultaat

value=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