CKTIS / C++
std::basic_ostream::flush — sinkronizacija izlaznog međuspremnika
std::basic_ostream::flush zahtijeva sinkronizaciju međuspremnika toka i vraća referencu na isti tok. Ne dodaje znak novog retka; neuspjeh sinkronizacije prijavljuje se putem badbit.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
basic_ostream& flush();
// Usage:
os.flush();std::basic_ostream::flush neformatirana je izlazna funkcija koja se poziva kao os.flush(). Vraća *this, što omogućuje ulančavanje operacija. Sama ne dodaje znakove.
Ako rdbuf() nije nul-pokazivač, stvara se objekt sentry. Kada taj objekt dopusti operaciju, poziva se rdbuf()->pubsync(). Rezultat -1 uzrokuje poziv setstate(badbit), koji, ovisno o maski iznimki, može izbaciti std::ios_base::failure. Ako sentry ne dopusti operaciju, sinkronizacija se preskače.
os << std::flush poziva istu člansku funkciju. std::endl dodatno umeće znak novog retka prije njezina poziva. Sinkronizacija ovisi o vrsti međuspremnika; ne treba je izjednačavati s jamstvom trajnog pohranjivanja na fizičkom mediju.
Primjer upotrebljava prilagođeni međuspremnik čiji sync() broji pozive i prijavljuje uspjeh. Čak i ako nema pohranjenih znakova, out.flush() poziva sinkronizaciju; očekivani je izlaz 1 nakon kojeg slijedi znak novog retka.
Primjeri
#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';
}
Rezultat
1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.