WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::cerr: Standardfehlerstrom

std::cerr ist der mit stderr verbundene schmale Ausgabestrom, mit unitbuf initialisiert und an std::cout gebunden.

Version: C++23

Syntax

namespace std {
    extern ostream cerr;
}

std::cerr aus <iostream> ist ein globaler std::ostream für den Puffer von C-stderr. Standardmäßig ist unitbuf gesetzt, und wegen cerr.tie() == &std::cout wird cout vor der Operation geleert. Bei unitbuf leert der Sentry-Destruktor cerr üblicherweise danach, wenn der Strom gut ist und keine Ausnahme abgewickelt wird.

Der Strom eignet sich für von normalen stdout-Daten getrennte Diagnosen, doch der Benutzer kann beide Deskriptoren zum selben Ziel umleiten. Eine aus mehreren <<-Operationen gebildete Nachricht ist keine Transaktion und kann sich mit Ausgaben anderer Threads vermischen.

Stromfehler setzen Zustandsbits; standardmäßig werfen sie nur bei passender exceptions()-Maske. unitbuf macht Diagnosen zeitnah, verursacht aber häufigere Flushes. Strukturierte, rotierende oder atomare Logs brauchen einen eigenen Mechanismus.

Beispiele

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

Ergebnis

error 7

std::cerr → error 7

Quellen