Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::basic_ostream::flush — sincronizar o buffer de saída

std::basic_ostream::flush solicita a sincronização do buffer de um fluxo e devolve uma referência para esse mesmo fluxo. Não acrescenta uma mudança de linha; as falhas de sincronização são assinaladas através de badbit.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

std::basic_ostream::flush é uma função de saída não formatada, chamada como os.flush(). Devolve *this, permitindo encadear operações. Não acrescenta caracteres por si própria.

Se rdbuf() não for um ponteiro nulo, é criado um objeto sentry. Quando este permite a operação, é chamado rdbuf()->pubsync(). Um resultado de -1 desencadeia setstate(badbit), que pode lançar std::ios_base::failure, dependendo da máscara de exceções. Se sentry não permitir a operação, a sincronização é ignorada.

os << std::flush chama a mesma função-membro. std::endl insere ainda uma mudança de linha antes de a chamar. A sincronização depende do tipo de buffer: não deve ser confundida com uma garantia de armazenamento duradouro num suporte físico.

O exemplo utiliza um buffer personalizado cujo sync() conta as chamadas e indica sucesso. Mesmo sem caracteres armazenados, out.flush() invoca a sincronização; o resultado esperado é 1 seguido de uma mudança de linha.

Exemplos

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

Resultado

1

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes