CKTIS / C
fclose — prúdová funkcia C23
`fclose(stream)` z `<stdio.h>` vyprázdni zadaný prúd, odovzdá nezapísané dáta hostiteľskému prostrediu, zahodí neprečítaný vstup, zatvorí pridružený súbor a odpojí objekt `FILE`. Pri úspechu vracia nulu, pri chybe `EOF`.
Verzia: C23
Syntax
int fclose(FILE *stream);fclose(stream) z <stdio.h> vyprázdni zadaný prúd, odovzdá nezapísané dáta hostiteľskému prostrediu, zahodí neprečítaný vstup, zatvorí pridružený súbor a odpojí objekt FILE. Pri úspechu vracia nulu, pri chybe EOF.
Príklad vytvorí tmpfile(), zapíše päť bajtov hello, zistí pozíciu pomocou ftell a potom zavolá fclose. 5 1 potvrdzuje logickú veľkosť pred zatvorením a nulový stav; dočasný súbor sa pritom odstráni.
Aj keď fclose oznámi chybu, prúd je odpojený a nesmie sa znova vyprázdňovať, zatvárať ani používať. Stav kontrolujte, pretože chyba zápisu bufferovaného výstupu sa môže prejaviť až pri zatvorení. stream musí označovať otvorený prúd; po volaní už ukazovateľ nie je platným ovládačom prúdu.
Príklady
#include <stdio.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputs("hello", stream) == EOF) { fclose(stream); return 1; }
long position = ftell(stream);
if (position < 0) { fclose(stream); return 1; }
int closed = fclose(stream);
printf("%ld %d\n", position, closed == 0);
return closed == 0 ? 0 : 1;
}
Výsledok
5 1
Príklad vytvorí `tmpfile()`, zapíše päť bajtov `hello`, zistí pozíciu pomocou `ftell` a potom zavolá `fclose`. `5 1` potvrdzuje logickú veľkosť pred zatvorením a nulový stav; dočasný súbor sa pritom odstráni.