CKTIS / C
fclose — proudová funkce C23
`fclose(stream)` z `<stdio.h>` vyprázdní zadaný proud, předá nezapsaná data hostitelskému prostředí, zahodí nepřečtený vstup, zavře přidružený soubor a odpojí objekt `FILE`. Při úspěchu vrací nulu, při chybě `EOF`.
Verze: C23
Syntaxe
int fclose(FILE *stream);fclose(stream) z <stdio.h> vyprázdní zadaný proud, předá nezapsaná data hostitelskému prostředí, zahodí nepřečtený vstup, zavře přidružený soubor a odpojí objekt FILE. Při úspěchu vrací nulu, při chybě EOF.
Příklad vytvoří tmpfile(), zapíše pět bajtů hello, zjistí pozici pomocí ftell a potom zavolá fclose. 5 1 potvrzuje logickou velikost před zavřením a nulový stav; dočasný soubor je přitom odstraněn.
I když fclose oznámí chybu, proud je odpojen a nesmí se znovu vyprazdňovat, zavírat ani používat. Stav kontrolujte, protože chyba zápisu bufferovaného výstupu se může projevit až při zavření. stream musí označovat otevřený proud; po volání už ukazatel není platným ovladačem proudu.
Pří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ýsledek
5 1
Příklad vytvoří `tmpfile()`, zapíše pět bajtů `hello`, zjistí pozici pomocí `ftell` a potom zavolá `fclose`. `5 1` potvrzuje logickou velikost před zavřením a nulový stav; dočasný soubor je přitom odstraněn.