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.