CKTIS / C++
std::basic_ostream::flush — synchronizace výstupní vyrovnávací paměti
std::basic_ostream::flush požaduje synchronizaci vyrovnávací paměti proudu a vrací referenci na tentýž proud. Nepřidává znak nového řádku; selhání synchronizace se oznamuje pomocí badbit.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
basic_ostream& flush();
// Usage:
os.flush();std::basic_ostream::flush je neformátovaná výstupní funkce, která se volá jako os.flush(). Vrací *this, takže lze operace řetězit. Sama nepřidává žádné znaky.
Pokud rdbuf() není nulový ukazatel, vytvoří se objekt sentry. Jestliže tento objekt operaci povolí, zavolá se rdbuf()->pubsync(). Výsledek -1 způsobí volání setstate(badbit), které může podle masky výjimek vyvolat std::ios_base::failure. Pokud sentry operaci nepovolí, synchronizace se přeskočí.
os << std::flush volá tutéž členskou funkci. std::endl navíc před jejím zavoláním vloží znak nového řádku. Synchronizace závisí na typu vyrovnávací paměti; nelze ji považovat za záruku trvalého uložení na fyzickém médiu.
Příklad používá vlastní vyrovnávací paměť, jejíž sync() počítá volání a hlásí úspěch. I když nejsou uloženy žádné znaky, out.flush() synchronizaci vyvolá; očekávaný výstup je 1 následované znakem nového řádku.
Pří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ýsledek
1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.