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

CKTIS / C++

std::clog: fluxo padrão de registo

std::clog é o fluxo global de saída estreita associado ao stderr de C, sem unitbuf obrigatório.

Versão: C++23

Sintaxe

namespace std {
    extern ostream clog;
}

std::clog, de <iostream>, é um std::ostream global que escreve num buffer associado ao stderr de C. Serve para diagnósticos que podem ser armazenados em buffer; ao contrário de std::cerr, a norma não lhe impõe unitbuf nem ligação a std::cout.

As inserções seguem as regras normais de formatação e manipuladores e flags persistem nas escritas seguintes. Se um registo tiver de chegar antes de uma falha ou transferência de controlo, chama flush; uma nova linha por si só não garante esvaziar o fluxo C++.

Erros do dispositivo definem failbit ou badbit, pelo que deves verificar escritas importantes. Mensagens concorrentes podem intercalar caracteres e exigem sincronização por registo. Alterar rdbuf() ou sync_with_stdio(false) afeta estado global do processo; o exemplo repõe o buffer original.

Exemplos

#include <iostream>
#include <sstream>

int main() {
    std::ostringstream sink;
    auto* original = std::clog.rdbuf(sink.rdbuf());
    std::clog << "severity=" << 3;
    std::clog.rdbuf(original);
    std::cout << sink.str() << '\n';
}

Resultado

severity=3

std::clog → severity=3

Fontes