Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::cerr: standardowy strumień błędów

std::cerr jest wąskim strumieniem wyjściowym powiązanym z stderr, domyślnie z flagą unitbuf i związanym z std::cout.

Wersja: C++23

Składnia

namespace std {
    extern ostream cerr;
}

std::cerr z <iostream> jest globalnym std::ostream zapisującym do bufora powiązanego z C-owym stderr. Domyślnie ma ustawioną flagę unitbuf, a cerr.tie() == &std::cout powoduje opróżnienie cout przed operacją. Przy unitbuf destruktor sentry zwykle opróżnia cerr po operacji, gdy strumień jest w dobrym stanie i nie trwa propagacja wyjątku.

Nadaje się do diagnostyki oddzielanej od normalnych danych na stdout, ale użytkownik może oba deskryptory przekierować do tego samego miejsca. Pojedyncza wiadomość złożona z wielu operatorów << nie jest transakcją i przy zapisie z wielu wątków może przeplatać się z innymi.

Błędy strumienia ustawiają bity stanu; domyślnie nie muszą zgłaszać wyjątku, dopóki nie ustawi się maski exceptions(). unitbuf poprawia terminowość diagnostyki kosztem częstszych opróżnień. Do logów wymagających struktury, rotacji lub atomowości potrzebny jest osobny mechanizm.

Przykłady

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

Wynik

error 7

std::cerr → error 7

Źródła