WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::ostream und std::basic_ostream — Ausgabeströme

std::basic_ostream ist eine Vorlage für Ausgabeströme, und std::ostream ist ihr Alias für char. Damit lassen sich Werte mit operator<< formatieren und Zeichen in einen zugehörigen Streampuffer schreiben.

Version: 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> aus <ostream> stellt eine Schnittstelle für die Ausgabe in einen Streampuffer bereit. CharT legt den Zeichentyp fest, während Traits die Zeichenoperationen bereitstellt; der Standardwert ist std::char_traits<CharT>. std::ostream ist genau ein Alias für std::basic_ostream<char>, keine eigene Vorlage und kein Ausgabeobjekt.

operator<< formatiert Werte wie Zahlen. Einfügeoperationen geben eine Referenz auf den Stream zurück und ermöglichen so das Verketten von Aufrufen. put(c) schreibt ein einzelnes Zeichen, während write(s, n) n Zeichen ohne Formatierung schreibt, sofern die Ausgabe nicht fehlschlägt. flush() fordert die Synchronisierung des zugehörigen Puffers an; eine dauerhafte Speicherung auf dem Datenträger wird dadurch nicht garantiert.

Nimm std::ostream& entgegen, damit eine Funktion den übergebenen Stream ohne Kopie verwenden kann. Im Beispiel erhält write_value std::cout und gibt denselben Stream zurück; anschließend fügt put('\n') ein Zeilenumbruchzeichen an. Ein bloßes \n fordert kein Leeren des Puffers an; das Beispiel ruft flush() ausdrücklich auf.

Ausgabefehler werden über den Streamzustand gemeldet, unter anderem durch failbit oder badbit; die Ausnahmemaske kann das Auslösen einer Ausnahme bewirken. Gehe nicht davon aus, dass das Ausbleiben einer Ausnahme Erfolg bedeutet: Prüfe den Zustand wie in der abschließenden Bedingung des Beispiels. Dieser Eintrag bezieht sich auf C++23; der angegebene Kompilierungsstandard bestätigt keine Produktionslaufzeitumgebung. Die Quellen stellen einen sich weiterentwickelnden Standardentwurf dar.

Beispiele

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

Ergebnis

value=42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen