NAZWA

       fflush - wypróżnia bufory strumienia

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

SKŁADNIA

       #include <stdio.h>

       int fflush(FILE *_Nullable stream);

OPIS

       Użyta  na  strumieniach  wyjściowych  funkcja  fflush()  wymusza  zapis  wszystkich danych
       buforowanych w przestrzeni użytkownika dla  danego  wyjścia  lub  aktualizację  strumienia
       stream za pomocą należącej do niego funkcji zapisu.

       W  przypadku  strumieni wejściowych skojarzonych z plikami, po których można się przesuwać
       (na przykład pliki dyskowe, ale nie potoki czy terminale) fflush()  usuwa  wszelkie  dane,
       które zostały odczytane z pliku, ale jeszcze nie zostały pobrane przez aplikację.

       Stan otwarcia strumienia nie jest zmieniany (tj. pozostaje on nadal otwarty).

       Jeśli  argument stream jest równy NULL, to fflush() wypróżnia wszystkie otwarte strumienie
       wyjściowe.

       Informacje o nieblokujących odpowiednikach znajdują się w unlocked_stdio(3).

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.

BŁĘDY

       EBADF  stream nie jest otwartym strumieniem lub nie jest otwarty do zapisu.

       Funkcja fflush() może także zawieść i ustawić wartość errno na dowolny błąd wymieniony dla
       write(2).

ATRYBUTY

       Informacje  o  pojęciach  używanych  w  tym  rozdziale   można   znaleźć   w   podręczniku
       attributes(7).

       ┌────────────────────────────────────────────────┬────────────────────────┬───────────────┐
       │Interfejs                                       │ Atrybut                │ Wartość       │
       ├────────────────────────────────────────────────┼────────────────────────┼───────────────┤
       │fflush()                                        │ Bezpieczeństwo wątkowe │ MT-bezpieczne │
       └────────────────────────────────────────────────┴────────────────────────┴───────────────┘

STANDARDY

       C11, POSIX.1-2008.

HISTORIA

       C89, POSIX.1-2001, POSIX.1-2008.

       POSIX.1-2001  nie określa zachowania podczas opróżniania strumieni wejściowych; zostało to
       opisane  w standardzie POSIX.1-2008.

UWAGI

       Należy zauważyć, że fflush() 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

       fsync(2),  sync(2),  write(2),  fclose(3),  fileno(3),  fopen(3),  fpurge(3),   setbuf(3),
       unlocked_stdio(3)

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia   niniejszej   strony   podręcznika   są:  Adam  Byrtek
       <alpha@irc.pl>,  Andrzej  Krzysztofowicz  <ankry@green.mf.pg.gda.pl>  i   Robert   Luberda
       <robert@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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   lub   nowszej.   Nie  przyjmuje  się  ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy w tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej
       ⟨manpages-pl-list@lists.sourceforge.net⟩.