Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła