Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::basic_ostream::flush — sincronizzare il buffer di output

std::basic_ostream::flush richiede la sincronizzazione del buffer di uno stream e restituisce un riferimento allo stesso stream. Non aggiunge un carattere di nuova riga; gli errori di sincronizzazione vengono segnalati tramite badbit.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

basic_ostream& flush();
// Usage:
os.flush();

std::basic_ostream::flush è una funzione di output non formattata, chiamata come os.flush(). Restituisce *this, consentendo di concatenare le operazioni. Non aggiunge caratteri di propria iniziativa.

Se rdbuf() non è un puntatore nullo, viene creato un oggetto sentry. Quando questo consente l’operazione, viene chiamato rdbuf()->pubsync(). Un risultato pari a -1 attiva setstate(badbit), che può lanciare std::ios_base::failure a seconda della maschera delle eccezioni. Se sentry non consente l’operazione, la sincronizzazione viene saltata.

os << std::flush chiama la stessa funzione membro. std::endl inserisce inoltre un carattere di nuova riga prima di chiamarla. La sincronizzazione dipende dal tipo di buffer: non va confusa con una garanzia di memorizzazione durevole su un supporto fisico.

L’esempio usa un buffer personalizzato il cui sync() conta le chiamate e segnala il successo. Anche senza caratteri memorizzati, out.flush() invoca la sincronizzazione; l’output atteso è 1 seguito da una nuova riga.

Esempi

#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';
}

Risultato

1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti