Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::clog: standardowy strumień logów

std::clog jest globalnym wąskim strumieniem wyjściowym powiązanym z C-owym stderr, bez gwarantowanego unitbuf.

Wersja: C++23

Składnia

namespace std {
    extern ostream clog;
}

std::clog z <iostream> jest globalnym std::ostream, który zapisuje do bufora powiązanego z C-owym stderr. Służy do komunikatów diagnostycznych, które mogą być buforowane; w odróżnieniu od std::cerr standard nie ustawia dla niego flagi unitbuf ani nie wiąże go z std::cout.

Operacje operator<< używają zwykłych reguł formatowania strumieni, a manipulatory i flagi pozostają aktywne dla kolejnych zapisów. Gdy log musi dotrzeć przed awarią lub przekazaniem sterowania, wywołaj flush; sam znak nowej linii nie gwarantuje opróżnienia C++-owego strumienia.

Błędy urządzenia ustawiają failbit lub badbit, dlatego ważny zapis trzeba sprawdzić. Równoległe komunikaty mogą mieszać znaki, więc całe rekordy wymagają synchronizacji. Zmiana rdbuf() lub sync_with_stdio(false) wpływa na globalny stan procesu; przykład przywraca oryginalny bufor.

Przykłady

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

Wynik

severity=3

std::clog → severity=3

Źródła