CKTIS / C++
std::basic_ostream::flush — de uitvoerbuffer synchroniseren
std::basic_ostream::flush vraagt synchronisatie van de buffer van een stream aan en geeft een verwijzing naar dezelfde stream terug. De functie voegt geen regeleinde toe; een synchronisatiefout wordt gemeld via badbit.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
basic_ostream& flush();
// Usage:
os.flush();std::basic_ostream::flush is een onopgemaakte uitvoerfunctie en wordt aangeroepen als os.flush(). De functie geeft *this terug, zodat bewerkingen aan elkaar kunnen worden gekoppeld. Zelf voegt ze geen tekens toe.
Als rdbuf() geen null-pointer is, wordt een sentry-object gemaakt. Als dit object de bewerking toestaat, wordt rdbuf()->pubsync() aangeroepen. Een resultaat van -1 leidt tot setstate(badbit), wat afhankelijk van het uitzonderingsmasker std::ios_base::failure kan gooien. Als sentry de bewerking niet toestaat, wordt de synchronisatie overgeslagen.
os << std::flush roept dezelfde memberfunctie aan. std::endl voegt bovendien een regeleinde in voordat de functie wordt aangeroepen. Synchronisatie hangt af van het buffertype en moet niet worden opgevat als een garantie voor blijvende opslag op een fysiek medium.
Het voorbeeld gebruikt een aangepaste buffer waarvan sync() het aantal aanroepen telt en succes meldt. Ook als er geen tekens zijn opgeslagen, roept out.flush() de synchronisatie aan; de verwachte uitvoer is 1 gevolgd door een regeleinde.
Voorbeelden
#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';
}
Resultaat
1
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.