Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::cerr: standardní chybový proud

std::cerr je úzký výstupní proud spojený se stderr, inicializovaný s unitbuf a svázaný se std::cout.

Verze: C++23

Syntaxe

namespace std {
    extern ostream cerr;
}

std::cerr z <iostream> je globální std::ostream pro buffer C stderr. unitbuf je standardně nastaven a cerr.tie() == &std::cout před operací vyprázdní cout. S unitbuf sentry destruktor obvykle poté vyprázdní cerr, je-li proud good a neprobíhá šíření výjimky.

Hodí se pro diagnostiku oddělenou od běžných dat na stdout, uživatel však může oba deskriptory přesměrovat na stejné místo. Zpráva z několika << není transakce a může se prokládat s výstupem jiných vláken.

Chyby proudu nastaví stavové bity; standardně nemusí vyhodit výjimku bez masky exceptions(). unitbuf zrychluje diagnostiku za cenu častějšího flush. Strukturované, rotované či atomické logy potřebují zvláštní mechanismus.

Příklady

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

Výsledek

error 7

std::cerr → error 7

Zdroje