NAZWA

       fgetc, fgets, getc, getchar, gets, ungetc - wprowadzanie znaków i łańcuchów znakowych

SKŁADNIA

       #include <stdio.h>

       int fgetc(FILE *stream);

       char *fgets(char *s, int size, FILE *stream);

       int getc(FILE *stream);

       int getchar(void);

       char *gets(char *s);

       int ungetc(int c, FILE *stream);

OPIS

       fgetc() odczytuje następny znak ze stream i zwraca go jako rzutowanie unsigned char na int
       lub zwraca EOF w przypadku końca pliku albo błędu.

       getc() jest równoważne fgetc() z tym wyjątkiem, że może być zaimplementowane  jako  makro,
       które wylicza stream więcej niż raz.

       getchar() jest równoważne getc(stdin).

       gets() odczytuje linię z stdin do bufora wskazywanego przez s aż do kończącego znaku nowej
       linii lub EOF, który  jest  zastępowany  przez  bajt  null  ('\0').  Nie  jest  sprawdzane
       przepełnienie bufora (zobacz BŁĘDY IMPLEMENTACJI poniżej).

       fgets()  odczytuje  co  najwyżej  o jeden mniej niż size znaków ze stream i umieszcza je w
       buforze wskazywanym przez s.  Odczyt kończy się po napotkaniu EOF lub znaku  nowej  linii.
       Jeśli  odczytany  zostanie  znak nowej linii, jest on przechowywany w buforze. Po ostatnim
       znaku w buforze jest umieszczany kończący bajt null ('\0').

       ungetc() odkłada c z powrotem do stream, rzutowane na unsigned char, o ile jest to możliwe
       dla  następnych  operacji  odczytu.  Odłożone  znaki będą zwracane w odwrotnej kolejności;
       tylko jedno pomyślne odłożenie jest zagwarantowane.

       Wywołania opisanych tu funkcji mogą być mieszane między sobą jak i  z  wywołaniami  innych
       funkcji wejściowych z biblioteki stdio operujących na tym samym strumieniu wejściowym.

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

WARTOŚĆ ZWRACANA

       fgetc(),  getc()  i getchar() zwracają odczytany znak jako unsigned char  rzutowany na int
       lub zwracają EOF w przypadku błędu.

       gets() i fgets() zwracają s w przypadku pomyślnego zakończenia lub NULL w przypadku  błędu
       lub wystąpienia końca pliku przed odczytaniem jakiegokolwiek znaku.

       ungetc() zwraca c w przypadku pomyślnego zakończenia lub EOF w przypadku błędu.

ZGODNE Z

       C89, C99, POSIX.1-2001.

       LSB  uznaje  gets() za wychodzącą z użycia. POSIX.1-2008 oznacza ją jako przestarzałą. ISO
       C11 usuwa definicję gets() z języka C i od wersji 2.16 biblioteki glibc  pliki  nagłówkowe
       nie zawierają deklaracji tej funkcji, jeśli zdefiniowane jest makro _ISOC11_SOURCE.

BŁĘDY IMPLEMENTACJI

       Nigdy  nie  należy  używać  gets().  Funkcja  ta  jest szczególnie niebezpieczna w użyciu,
       ponieważ bez znajomości danych z góry nie  jest  możliwe  określenie,  ile  znaków  gets()
       przeczyta, i ponieważ gets() będzie kontynuować umieszczanie znaków po przekroczeniu końca
       bufora. Było to wykorzystywane do łamania zabezpieczeń komputerów. Zamiast  gets()  należy
       korzystać z fgets().

       Nie   jest   zalecane   mieszanie   wywołań  funkcji  wejściowych  z  biblioteki  stdio  z
       niskopoziomowymi wywołaniami read(2) dla deskryptora pliku stowarzyszonego ze  strumieniem
       wejściowym;  wyniki  będą  nieokreślone  i  z  dużym prawdopodobieństwem nie takie, jakich
       oczekiwano.

ZOBACZ TAKŻE

       read(2),  write(2),  ferror(3),  fgetwc(3),  fgetws(3),  fopen(3),   fread(3),   fseek(3),
       getline(3),     getwchar(3),    puts(3),    scanf(3),    ungetwc(3),    unlocked_stdio(3),
       feature_test_macros(7)

O STRONIE

       This page is part of release 3.52 of the Linux man-pages project.  A  description  of  the
       project,     and    information    about    reporting    bugs,    can    be    found    at
       http://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami polskiego tłumaczenia niniejszej strony podręcznika man są: Przemek  Borys  (PTM)
       <pborys@dione.ids.pl>,  Andrzej  Krzysztofowicz  (PTM) <ankry@green.mf.pg.gda.pl> i Robert
       Luberda <robert@debian.org>.

       Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów  na
       stronie   http://sourceforge.net/projects/manpages-pl/.   Jest   zgodne   z  wersją   3.52
       oryginału.