std::cerr, std::wcerr

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Ein-/Ausgabe-Bibliothek

I/O-Manipulatoren

Print-Funktionen (C++23)

C-Style I/O

Puffer

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

Streams

Abstraktionen

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

Datei-I/O

basic_ifstream

basic_ofstream

basic_fstream

String-I/O

basic_istringstream

basic_ostringstream

basic_stringstream

Array-I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

Synchronisierte Ausgabe

basic_osyncstream (C++20)

Typen

streamoff

streamsize

fpos

Fehlerkategorie-Schnittstelle

iostream_category (C++11)

io_errc (C++11)

 

std::basic_ostream

Globale Objekte
coutwcout	cerrwcerr	clogwclog
Memberfunktionen
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
Formatierte Ausgabe
basic_ostream::operator<<
Unformatierte Ausgabe
basic_ostream::put
basic_ostream::write
Positionierung
basic_ostream::tellp
basic_ostream::seekp
Sonstiges
basic_ostream::flush
basic_ostream::swap (C++11)
Member-Klassen
basic_ostream::sentry
Nicht-Member-Funktionen
operator<<(std::basic_ostream)
print(std::ostream) (C++23)
println(std::ostream) (C++23)
vprint_unicode(std::ostream) (C++23)
vprint_nonunicode(std::ostream) (C++23)

 

Definiert in Header <iostream>
extern std::ostream cerr;	(1)
extern std::wostream wcerr;	(2)

Die globalen Objekte std::cerr und std::wcerr steuern die Ausgabe in einen Stream-Puffer vom Implementierungs-definierten Typ (abgeleitet von std::streambuf bzw. std::wstreambuf), der mit dem Standard-C-Fehlerausgabe-Stream stderr verbunden ist.

Es wird garantiert, dass diese Objekte während oder vor der ersten Konstruktion eines Objekts vom Typ std::ios_base::Init initialisiert werden und für die Verwendung in den Konstruktoren und Destruktoren von statischen Objekten mit geordneter Initialisierung verfügbar sind (solange <iostream> vor der Definition des Objekts inkludiert wird).

Sofern nicht std::ios_base::sync_with_stdio(false) aufgerufen wurde, ist es sicher, diese Objekte aus mehreren Threads für formatierte und unformatierte Ausgaben gleichzeitig zu verwenden.

Nach der Initialisierung ist (std::cerr.flags() & unitbuf) != 0 (dasselbe gilt für std::wcerr), was bedeutet, dass jede an diese Stream-Objekte gesendete Ausgabe sofort an das Betriebssystem geleert wird (über den Destruktor von std::basic_ostream::sentry).

Zusätzlich gibt std::cerr.tie() &std::cout zurück (dasselbe gilt für std::wcerr und std::wcout), was bedeutet, dass jede Ausgabeoperation auf std::cerr zuerst std::cout leert (über den Konstruktor von std::basic_ostream::sentry).

Hinweise

Das 'c' im Namen steht für "character" ("Zeichen") (stroustrup.com FAQ); cerr bedeutet "character error (stream)" und wcerr bedeutet "wide character error (stream)".

Beispiel

Die Ausgabe nach stderr über std::cerr leert die ausstehende Ausgabe auf std::cout, während die Ausgabe nach stderr über std::clog dies nicht tut.

Führen Sie diesen Code aus

#include <chrono>
#include <iostream>
#include <thread>
using namespace std::chrono_literals;
 
void f()
{
    std::cout << "Output from thread...";
    std::this_thread::sleep_for(2s);
    std::cout << "...thread calls flush()" << std::endl;
}
 
int main()
{
    std::jthread t1{f};
    std::this_thread::sleep_for(1000ms);
    std::clog << "This output from main is not tie()'d to cout\n";
    std::cerr << "This output is tie()'d to cout\n";
}

Mögliche Ausgabe

This output from main is not tie()'d to cout
Output from thread...This output is tie()'d to cout
...thread calls flush()

Defect reports

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 455	C++98	std::cerr.tie() und std::wcerr.tie() gaben Nullzeiger zurück	sie geben stattdessen &std::cout und &std::wcout zurück

Siehe auch

Init	initialisiert Standard-Stream-Objekte (public member class of std::ios_base)
clogwclog	schreibt in den Standard-C-Fehlerstrom stderr (globales Objekt)
coutwcout	schreibt in den Standard-C-Ausgabestrom stdout (globales Objekt)
stdinstdoutstderr	Ausdruck vom Typ FILE*, der dem Eingabestrom zugeordnet ist Ausdruck vom Typ FILE*, der dem Ausgabestrom zugeordnet ist Ausdruck vom Typ FILE*, der dem Fehlerstrom zugeordnet ist (Makrokonstante)