CKTIS / C
fclose — funkcja strumieniowa C23
`fclose(stream)` z `<stdio.h>` opróżnia wskazany strumień, dostarcza niezapisane dane do środowiska hosta, odrzuca nieprzeczytane dane wejściowe, zamyka powiązany plik i odłącza obiekt `FILE`. Zwraca zero przy powodzeniu albo `EOF` przy błędzie.
Wersja: C23
Składnia
int fclose(FILE *stream);fclose(stream) z <stdio.h> opróżnia wskazany strumień, dostarcza niezapisane dane do środowiska hosta, odrzuca nieprzeczytane dane wejściowe, zamyka powiązany plik i odłącza obiekt FILE. Zwraca zero przy powodzeniu albo EOF przy błędzie.
Przykład tworzy tmpfile(), zapisuje pięć bajtów hello, odczytuje pozycję przez ftell, a następnie wywołuje fclose. Wynik 5 1 potwierdza rozmiar logiczny przed zamknięciem i zerowy status zamknięcia; plik tymczasowy jest wtedy usuwany.
Nawet gdy fclose zgłosi błąd, strumień jest odłączony i nie wolno go ponownie opróżniać, zamykać ani używać. Sprawdzaj status, bo błąd zapisu buforowanych danych może ujawnić się dopiero przy zamykaniu. stream musi wskazywać otwarty strumień; po wywołaniu wskaźnik jest nieważny jako uchwyt strumienia.
Przykłady
#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;
}
Wynik
5 1
Przykład tworzy `tmpfile()`, zapisuje pięć bajtów `hello`, odczytuje pozycję przez `ftell`, a następnie wywołuje `fclose`. Wynik `5 1` potwierdza rozmiar logiczny przed zamknięciem i zerowy status zamknięcia; plik tymczasowy jest wtedy usuwany.