stdin, stdout, stderr

 

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)

 

C-Style I/O

Typen und Objekte
FILE fpos_t	stdinstdoutstderr
Funktionen
Datei-Zugriff fopen freopen fclose fflush fwide setbuf setvbuf Direkte Ein-/Ausgabe fread fwrite Unformatierte Ein-/Ausgabe fgetcgetc fgets fputcputc fputs getchar gets (bis C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc Formatierte Eingabe scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	Formatierte Ausgabe printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf Dateipositionierung ftell fgetpos fseek fsetpos rewind Fehlerbehandlung clearerr feof ferror perror Operationen auf Dateien remove rename tmpfile tmpnam

 

Definiert in Header <cstdio>
#define stdin  /* implementierungsabhängig */	(1)
#define stdout /* implementierungsabhängig */	(2)
#define stderr /* implementierungsabhängig */	(3)

Drei Textströme sind vordefiniert. Diese Ströme werden beim Programmstart implizit geöffnet und sind unorientiert.

1) Verbunden mit dem Standard-Eingabestrom, der zum Lesen konventioneller Eingaben verwendet wird. Beim Programmstart ist der Strom vollständig gepuffert, wenn und nur wenn festgestellt werden kann, dass der Strom nicht auf ein interaktives Gerät verweist.

2) Verbunden mit dem Standard-Ausgabestrom, der zum Schreiben konventioneller Ausgaben verwendet wird. Beim Programmstart ist der Strom vollständig gepuffert, wenn und nur wenn festgestellt werden kann, dass der Strom nicht auf ein interaktives Gerät verweist.

3) Verbunden mit dem Standard-Fehlerstrom, der zum Schreiben von Diagnoseausgaben verwendet wird. Beim Programmstart ist der Strom nicht vollständig gepuffert.

Was ein interaktives Gerät darstellt, ist implementierungsabhängig.

Diese Makros werden zu Ausdrücken vom Typ std::FILE* erweitert.

Hinweise

Obwohl nicht von POSIX vorgeschrieben, ist die UNIX-Konvention, dass stdin und stdout zeilenweise gepuffert sind, wenn sie mit einem Terminal verbunden sind, und stderr unbuffered ist.

Diese Makros können zu modifizierbaren Lvalues erweitert werden. Wenn eines dieser std::FILE* Lvalues modifiziert wird, führen nachfolgende Operationen auf dem entsprechenden Strom zu nicht spezifiziertem oder undefiniertem Verhalten.

Beispiel

Dieses Beispiel zeigt eine Funktion ähnlich wie std::printf.

Führen Sie diesen Code aus

#include <concepts>
#include <cstdio>
#include <type_traits>
 
template<typename T>
concept IsPrintable = std::integral<T> or std::floating_point<T> or std::is_pointer_v<T>;
 
int my_printf(char const* const format, IsPrintable auto const ... arguments)
{
    return std::fprintf(stdout, format, arguments...);
}
 
int main(int argv, char*[])
{
    my_printf("Strings and chars:\t%s %c\n", "hello", 'x');
    my_printf("Rounding:\t\t%f %.0f %.32f\n", 1.5, 1.5, 1.3);
    my_printf("Padding:\t\t%05.2f %.2f %5.2f\n", 1.5, 1.5, 1.5);
    my_printf("Scientific:\t\t%E %e\n", 1.5, 1.5);
    my_printf("Hexadecimal:\t\t%a %A 0x%X\n", 1.5, 1.5, &argv);
}

Mögliche Ausgabe

Strings and chars:  hello x
Rounding:           1.500000 2 1.30000000000000004440892098500626
Padding:            01.50 1.50  1.50
Scientific:         1.500000E+00 1.500000e+00
Hexadecimal:        0x1.8p+0 0X1.8P+0 0x2CFB41BC

Siehe auch

cinwcin	liest vom Standard-C-Eingabestrom stdin (globales Objekt)
coutwcout	schreibt in den Standard-C-Ausgabestrom stdout (globales Objekt)
cerrwcerr	schreibt in den Standard-C-Fehlerstrom stderr, unbuffered (globales Objekt)
clogwclog	schreibt in den Standard-C-Fehlerstrom stderr (globales Objekt)
printffprintfsprintfsnprintf (C++11)	gibt formatierte Ausgabe auf stdout, einen Dateistrom oder einen Puffer aus (Funktion)
FILE	Objekttyp, der alle für die Steuerung eines C-I/O-Streams benötigten Informationen speichern kann (typedef)
C-Dokumentation für stdin, stdout, stderr