WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::clog: Standardstrom für Protokolle

std::clog ist der globale schmale Ausgabestrom zum C-stderr, ohne vorgeschriebene unitbuf-Einstellung.

Version: C++23

Syntax

namespace std {
    extern ostream clog;
}

std::clog aus <iostream> ist ein globaler std::ostream, der in einen mit C-stderr verbundenen Puffer schreibt. Er eignet sich für Diagnosemeldungen, die gepuffert sein dürfen; anders als bei std::cerr schreibt der Standard weder unitbuf noch eine Bindung an std::cout vor.

Einfügungen folgen den normalen Formatierungsregeln, und Manipulatoren sowie Flags gelten für spätere Ausgaben weiter. Muss ein Protokolleintrag vor Absturz oder Kontrollübergabe ankommen, ist flush aufzurufen; Newline allein garantiert kein Leeren des C++-Stroms.

Gerätefehler setzen failbit oder badbit; wichtige Ausgaben sind zu prüfen. Parallele Meldungen können Zeichen vermischen und brauchen Synchronisierung ganzer Datensätze. Änderungen an rdbuf() oder sync_with_stdio(false) betreffen globalen Prozesszustand; das Beispiel stellt den ursprünglichen Puffer wieder her.

Beispiele

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

Ergebnis

severity=3

std::clog → severity=3

Quellen