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.