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

CKTIS / C++

std::cerr: fluxo de erro padrão

std::cerr é o fluxo de saída estreito associado a stderr, inicializado com unitbuf e ligado a std::cout.

Versão: C++23

Sintaxe

namespace std {
    extern ostream cerr;
}

std::cerr, de <iostream>, é um std::ostream global para o buffer de stderr de C. unitbuf está ativo por predefinição e cerr.tie() == &std::cout esvazia cout antes da operação. Com unitbuf, o destrutor sentry normalmente esvazia cerr depois se o fluxo está good e nenhuma exceção está em propagação.

É útil para diagnóstico separado dos dados normais de stdout, mas o utilizador pode redirecionar ambos os descritores para o mesmo destino. Uma mensagem construída por vários << não é uma transação e pode intercalar-se com a saída de outras threads.

Falhas definem bits de estado; por predefinição não têm de lançar sem uma máscara exceptions(). unitbuf torna o diagnóstico atempado à custa de mais flushes. Logs estruturados, rotativos ou atómicos exigem um mecanismo dedicado.

Exemplos

#include <iostream>
#include <sstream>

int main() {
    std::ostringstream captured;
    auto* original = std::cerr.rdbuf(captured.rdbuf());
    std::cerr << "error " << 7;
    std::cerr.rdbuf(original);
    std::cout << captured.str() << '\n';
}

Resultado

error 7

std::cerr → error 7

Fontes