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