Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

freopen — funkcja strumieniowa C23

`freopen(filename, mode, stream)` z `<stdio.h>` zamyka plik związany ze strumieniem i ponownie wiąże ten sam obiekt `FILE` z plikiem oraz trybem wskazanym przez argumenty. Zwraca `stream` przy powodzeniu albo null przy błędzie.

Wersja: C23

Składnia

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

freopen(filename, mode, stream) z <stdio.h> zamyka plik związany ze strumieniem i ponownie wiąże ten sam obiekt FILE z plikiem oraz trybem wskazanym przez argumenty. Zwraca stream przy powodzeniu albo null przy błędzie.

Przykład najpierw tworzy nazwany plik do zapisu, zapisuje 42, a potem wywołuje freopen(name, "r", stream) i odczytuje tę wartość. Wynik 1 42 pokazuje udane ponowne otwarcie tego samego strumienia w innym trybie.

Błędy podczas zamykania starego pliku są ignorowane, a po nieudanym freopen pierwotny strumień jest zamknięty, więc nie wolno go dalej używać. Przy filename == NULL funkcja próbuje zmienić tryb pliku o bieżącej nazwie; implementacja określa dozwolone zmiany trybu i okoliczności ich wykonania. Sprawdzaj zwrot przed I/O; w może obciąć, a a dopisuje.

Przykłady

#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;}

Wynik

1 42

Przykład najpierw tworzy nazwany plik do zapisu, zapisuje `42`, a potem wywołuje `freopen(name, "r", stream)` i odczytuje tę wartość. Wynik `1 42` pokazuje udane ponowne otwarcie tego samego strumienia w innym trybie.

Źródła