freopen, freopen_s

FILE* freopen( const char* filename, const char* mode,
               FILE* stream );

FILE* freopen( const char* restrict filename, const char* restrict mode,
               FILE* restrict stream );

errno_t freopen_s( FILE* restrict* restrict newstreamptr,
                   const char* restrict filename, const char* restrict mode,
                   FILE* restrict stream );

1) Zuerst wird versucht, die mit stream verknüpfte Datei zu schließen, wobei alle Fehler ignoriert werden. Wenn filename nicht null ist, wird dann versucht, die durch filename angegebene Datei unter Verwendung von mode zu öffnen, als ob durch fopen, und diese Datei wird mit dem Dateistrom verbunden, auf den stream zeigt. Wenn filename ein Nullzeiger ist, versucht die Funktion, die bereits mit stream verbundene Datei wieder zu öffnen (es ist implementierungsdefiniert, welche Modusänderungen in diesem Fall erlaubt sind).

2) Wie (1), außer dass mode wie in fopen_s behandelt wird und dass der Zeiger auf den Dateistrom in newstreamptr geschrieben wird und die folgenden Fehler zur Laufzeit erkannt werden und die derzeit installierte Einschränkungs-Handler-Funktion aufrufen:

• newstreamptr ist ein Nullzeiger
• stream ist ein Nullzeiger
• mode ist ein Nullzeiger

Wie bei allen grenzgeprüften Funktionen ist freopen_s nur garantiert verfügbar, wenn __STDC_LIB_EXT1__ durch die Implementierung definiert ist und der Benutzer __STDC_WANT_LIB_EXT1__ auf die ganzzahlige Konstante 1 setzt, bevor er <stdio.h> einbindet.

1) Eine Kopie des Wertes von stream bei Erfolg, Nullzeiger bei Misserfolg.

2) Null bei Erfolg (und eine Kopie des Wertes von stream wird in *newstreamptr geschrieben), ungleich Null bei Fehler (und ein Nullzeiger wird in *newstreamptr geschrieben, es sei denn, newstreamptr ist selbst ein Nullzeiger).

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    puts("stdout is printed to console");
    if (freopen("redir.txt", "w", stdout) == NULL)
    {
       perror("freopen() failed");
       return EXIT_FAILURE;
    }
    puts("stdout is redirected to a file"); // this is written to redir.txt
    fclose(stdout);
    return EXIT_SUCCESS;
}

stdout is printed to console