CKTIS / C++
std::basic_ostream::flush — synchronizácia výstupnej vyrovnávacej pamäte
std::basic_ostream::flush požaduje synchronizáciu vyrovnávacej pamäte prúdu a vracia referenciu na ten istý prúd. Nepridáva znak nového riadka; zlyhanie synchronizácie sa oznamuje pomocou badbit.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
basic_ostream& flush();
// Usage:
os.flush();std::basic_ostream::flush je neformátovaná výstupná funkcia, ktorá sa volá ako os.flush(). Vracia *this, takže operácie možno reťaziť. Sama nepridáva žiadne znaky.
Ak rdbuf() nie je nulový ukazovateľ, vytvorí sa objekt sentry. Ak tento objekt operáciu povolí, zavolá sa rdbuf()->pubsync(). Výsledok -1 spôsobí volanie setstate(badbit), ktoré môže v závislosti od masky výnimiek vyvolať std::ios_base::failure. Ak sentry operáciu nepovolí, synchronizácia sa preskočí.
os << std::flush volá tú istú členskú funkciu. std::endl navyše pred jej zavolaním vloží znak nového riadka. Synchronizácia závisí od typu vyrovnávacej pamäte; nemožno ju považovať za záruku trvalého uloženia na fyzickom médiu.
Príklad používa vlastnú vyrovnávaciu pamäť, ktorej sync() počíta volania a hlási úspech. Aj keď nie sú uložené žiadne znaky, out.flush() vyvolá synchronizáciu; očakávaný výstup je 1 nasledované znakom nového riadka.
Príklady
#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';
}
Výsledok
1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.