CKTIS / C++
std::basic_ostream::flush — sinhronizacija izhodnega medpomnilnika
std::basic_ostream::flush zahteva sinhronizacijo medpomnilnika toka in vrne sklic na isti tok. Ne doda znaka za novo vrstico; neuspeh sinhronizacije sporoči prek badbit.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
basic_ostream& flush();
// Usage:
os.flush();std::basic_ostream::flush je neoblikovana izhodna funkcija, ki se pokliče kot os.flush(). Vrne *this, zato je mogoče operacije povezovati. Sama ne doda nobenih znakov.
Če rdbuf() ni ničelni kazalec, se ustvari objekt sentry. Če ta objekt operacijo dovoli, se pokliče rdbuf()->pubsync(). Rezultat -1 sproži setstate(badbit), ki lahko glede na masko izjem sproži std::ios_base::failure. Če sentry operacije ne dovoli, se sinhronizacija preskoči.
os << std::flush pokliče isto člansko funkcijo. std::endl pred njenim klicem dodatno vstavi znak za novo vrstico. Sinhronizacija je odvisna od vrste medpomnilnika; ne smemo je enačiti z jamstvom za trajno shranjevanje na fizičnem nosilcu.
Primer uporablja lasten medpomnilnik, katerega sync() šteje klice in sporoča uspeh. Tudi če niso shranjeni nobeni znaki, out.flush() sproži sinhronizacijo; pričakovani izhod je 1, ki mu sledi znak za novo vrstico.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.