NAZWA
fclose - zamknięcie strumienia
SKŁADNIA
#include <stdio.h>
int fclose(FILE *stream);
OPIS
Funkcja fclose() odłącza strumień stream od pliku (zapisując wszystkie zbuforowane dane wyjściowe za pomocą fflush(3)) i zamyka deskryptor pliku przypisanego do strumienia.
Zachowanie funkcji fclose() nie jest zdefiniowane, jeśli parametr stream nie jest poprawnym wskaźnikiem lub jeśli został już przekazany do wcześniejszego wywołania fclose().
WARTOŚĆ ZWRACANA
Jeśli funkcja zakończyła się pomyślnie, zwracane jest 0. W przeciwnym przypadku zwracana jest wartość EOF, a errno przyjmuje wartość, wskazującą na rodzaj błędu. W każdym przypadku następna próba dostępu (włączając w to kolejne wywołanie fclose()) do strumienia prowadzi do niezdefiniowanego zachowania.
BŁĘDY
EBADF |
Deskryptor pliku określający stream nie jest poprawny. |
Funkcja fclose() może także zawieść i ustawić wartość errno na dowolny błąd wymieniony w opisie funkcji close(2), write(2) lub fflush(3).
ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).
ZGODNE Z
POSIX.1-2001, POSIX.1-2008, C89, C99.
UWAGI
Należy zauważyć, że fclose() opróżnia jedynie bufory w przestrzeni użytkownika obsługiwane przez bibliotekę C. Aby upewnić się, że dane zostały fizycznie zapisane na dysku, należy zrzucić również bufory jądra, np. za pomocą sync(2) lub fsync(2).
ZOBACZ TAKŻE
close(2), fcloseall(3), fflush(3), fileno(3), fopen(3), setbuf(3)
O STRONIE
Angielska wersja tej strony pochodzi z wydania 5.07 projektu Linux man-pages. Opis projektu, informacje dotyczące zgłaszania błędów oraz najnowszą wersję oryginału można znaleźć pod adresem https://www.kernel.org/doc/man-pages/.
TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Adam Byrtek <alpha [AT] irc.pl>, Andrzej Krzysztofowicz <ankry [AT] green.pl> i Robert Luberda <robert [AT] debian.org>
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres <manpages-pl-list [AT] lists.net>.