Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori