Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::cerr : flux d’erreur standard

std::cerr est le flux de sortie étroit associé à stderr, initialisé avec unitbuf et lié à std::cout.

Version : C++23

Syntaxe

namespace std {
    extern ostream cerr;
}

std::cerr de <iostream> est un std::ostream global pour le tampon du stderr C. Le drapeau unitbuf est actif par défaut et cerr.tie() == &std::cout vide cout avant une opération. Avec unitbuf, le destructeur de sentry vide normalement cerr ensuite si le flux est bon et qu’aucune exception ne se propage.

Il convient aux diagnostics séparés des données normales de stdout, mais l’utilisateur peut rediriger les deux descripteurs vers la même destination. Un message composé de plusieurs << n’est pas une transaction et peut s’entrelacer avec la sortie d’autres threads.

Les échecs positionnent les bits d’état ; par défaut ils ne lèvent pas forcément d’exception sans masque exceptions(). unitbuf accélère le diagnostic au prix de vidages fréquents. Des journaux structurés, rotatifs ou atomiques exigent un mécanisme dédié.

Exemples

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

Résultat

error 7

std::cerr → error 7

Sources