std::freopen

 

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>
std::FILE* freopen( const char* filename, const char* mode, std::FILE* stream );

Versucht zuerst, die Datei, die mit stream verknüpft ist, zu schließen und ignoriert dabei alle Fehler. Dann, wenn filename nicht null ist, versucht es, die von filename spezifizierte Datei mit mode zu öffnen, als ob dies mit std::fopen geschehen wäre, und verknüpft diese Datei mit dem von stream gezeigten Dateistream. Wenn filename ein Nullzeiger ist, versucht die Funktion, die bereits mit stream verknüpfte Datei neu zu öffnen (welche Modifikationsänderungen in diesem Fall zulässig sind, ist implementierungsabhängig).

Parameter

filename	-	Dateiname, dem der Dateistream zugeordnet werden soll
mode	-	null-terminierter Zeichenstring, der den neuen Dateizugriffsmodus bestimmt
stream	-	der zu modifizierende Dateistream

Dateizugriffsmodi

Datei-Zugriff Modus-String	Bedeutung	Erklärung	Aktion, wenn Datei bereits existiert	Aktion, wenn Datei nicht existiert
"r"	read	Datei zum Lesen öffnen	lesen ab Anfang	gibt NULL zurück und setzt einen Fehler
"w"	schreiben	Datei zum Schreiben erstellen	Inhalt löschen	neu erstellen
"a"	append	An eine Datei anhängen	Ende schreiben	neu erstellen
"r+"	erweitertes Lesen	Datei zum Lesen/Schreiben öffnen	lesen ab Anfang	gibt NULL zurück und setzt einen Fehler
"w+"	erweitertes Schreiben	Datei zum Lesen/Schreiben erstellen	Inhalt löschen	neu erstellen
"a+"	erweitertes Anhängen	Datei zum Lesen/Schreiben öffnen	Ende schreiben	neu erstellen
Das Flag für den Dateizugriffsmodus "b" kann optional angegeben werden, um eine Datei im Binärmodus zu öffnen. Dieses Flag hat keine Auswirkung auf POSIX-Systeme, deaktiviert aber auf Windows beispielsweise die Sonderbehandlung von '\n' und '\x1A'. Bei Anhänge-Dateizugriffsmodi werden Daten am Ende der Datei geschrieben, unabhängig von der aktuellen Position des Dateipositionsindikators.
Das Flag für den Dateizugriffsmodus "x" kann optional an die Spezifizierer "w" oder "w+" angehängt werden. Dieses Flag zwingt die Funktion zum Fehlschlagen, wenn die Datei existiert, anstatt sie zu überschreiben. (C++17)
Das Verhalten ist undefiniert, wenn der Modus keiner der oben aufgeführten Strings ist. Einige Implementierungen definieren zusätzliche unterstützte Modi (z. B. Windows).

Rückgabewert

stream bei Erfolg, ein Nullzeiger bei Fehler.

Hinweise

std::freopen ist die einzige Möglichkeit, die für schmale/breite Zeichen ausgelegte Ausrichtung eines Streams zu ändern, sobald diese durch eine E/A-Operation oder durch std::fwide festgelegt wurde.

Die Microsoft CRT-Version von std::freopen unterstützt keine Modifikationsänderungen, wenn filename ein Nullzeiger ist und behandelt dies als Fehler (siehe Dokumentation). Eine mögliche Abhilfe ist die nicht standardmäßige Funktion _setmode().

Beispiel

Der folgende Code leitet stdout in eine Datei um.

Führen Sie diesen Code aus

#include <cstdio>
 
int main()
{
    std::printf("stdout is printed to console\n");
    if (std::freopen("redir.txt", "w", stdout))
    {
        std::printf("stdout is redirected to a file\n"); // this is written to redir.txt
        std::fclose(stdout);
    }
}

Ausgabe

stdout is printed to console

Siehe auch

fopen	öffnet eine Datei (function)
fclose	schließt eine Datei (function)
C-Dokumentation für freopen