CKTIS / C
freopen — C23-Datenstromfunktion
`freopen(filename, mode, stream)` aus `<stdio.h>` schließt die zum Strom gehörige Datei und verbindet dasselbe `FILE`-Objekt erneut mit Datei und Modus der Argumente. Es liefert `stream` bei Erfolg oder null bei Fehler.
Version: C23
Syntax
FILE *freopen(const char * restrict filename, const char * restrict mode, FILE * restrict stream);freopen(filename, mode, stream) aus <stdio.h> schließt die zum Strom gehörige Datei und verbindet dasselbe FILE-Objekt erneut mit Datei und Modus der Argumente. Es liefert stream bei Erfolg oder null bei Fehler.
Das Beispiel erzeugt zuerst eine benannte Datei, schreibt 42, ruft dann freopen(name, "r", stream) auf und liest den Wert. 1 42 zeigt erfolgreiches erneutes Öffnen desselben Stroms in anderem Modus.
Fehler beim Schließen der alten Datei werden ignoriert; nach fehlgeschlagenem freopen ist der ursprüngliche Strom geschlossen und unbrauchbar. Bei filename == NULL wird versucht, den Modus der bereits dem Strom zugeordneten Datei zu ändern; die Implementierung bestimmt erlaubte Änderungen und Umstände. Rückgabe vor I/O prüfen; w kann kürzen und a hängt an.
Beispiele
#include <stdio.h>
int main(void){const char *name="c_ref_21_freopen.tmp";FILE *stream=fopen(name,"w");if(!stream)return 1;if(fputs("42",stream)==EOF){fclose(stream);remove(name);return 1;}stream=freopen(name,"r",stream);if(!stream){remove(name);return 1;}int value=0,ok=fscanf(stream,"%d",&value)==1;int closed=fclose(stream),removed=remove(name);printf("%d %d\n",ok,value);return closed==0&&removed==0?0:1;}
Ergebnis
1 42
Das Beispiel erzeugt zuerst eine benannte Datei, schreibt `42`, ruft dann `freopen(name, "r", stream)` auf und liest den Wert. `1 42` zeigt erfolgreiches erneutes Öffnen desselben Stroms in anderem Modus.