CKTIS / C++
std::basic_ostream::flush — den Ausgabepuffer synchronisieren
std::basic_ostream::flush fordert die Synchronisierung des Stream-Puffers an und gibt eine Referenz auf denselben Stream zurück. Die Funktion fügt keinen Zeilenumbruch an; ein Synchronisierungsfehler wird über badbit gemeldet.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
basic_ostream& flush();
// Usage:
os.flush();std::basic_ostream::flush ist eine unformatierte Ausgabefunktion und wird als os.flush() aufgerufen. Sie gibt *this zurück, sodass sich Operationen verketten lassen. Sie fügt selbst keine Zeichen hinzu.
Ist rdbuf() kein Nullzeiger, wird ein sentry-Objekt erstellt. Lässt dieses die Operation zu, wird rdbuf()->pubsync() aufgerufen. Ein Ergebnis von -1 löst setstate(badbit) aus; abhängig von der Ausnahmemaske kann dadurch std::ios_base::failure ausgelöst werden. Lässt sentry die Operation nicht zu, wird die Synchronisierung übersprungen.
os << std::flush ruft dieselbe Memberfunktion auf. std::endl fügt zusätzlich vor ihrem Aufruf einen Zeilenumbruch ein. Die Synchronisierung hängt vom Puffertyp ab und ist nicht mit einer Garantie für dauerhaftes Speichern auf einem physischen Datenträger gleichzusetzen.
Das Beispiel verwendet einen eigenen Puffer, dessen sync() die Aufrufe zählt und Erfolg meldet. Auch wenn keine Zeichen gespeichert wurden, ruft out.flush() die Synchronisierung auf; die erwartete Ausgabe ist 1 gefolgt von einem Zeilenumbruch.
Beispiele
#include <iostream>
#include <ostream>
#include <streambuf>
class CountingBuffer : public std::streambuf {
public:
int sync_calls = 0;
protected:
int sync() override {
++sync_calls;
return 0;
}
};
int main() {
CountingBuffer buffer;
std::ostream out(&buffer);
out.flush();
std::cout << buffer.sync_calls << '\n';
}
Ergebnis
1
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.