Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri