ИМЯ

       fgetc, fgets, getc, getchar, ungetc - функции для ввода символов и строк

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <stdio.h>

       int fgetc(FILE *stream);
       int getc(FILE *stream);
       int getchar(void);

       char *fgets(char s[restrict .size], int size, FILE *restrict stream);

       int ungetc(int c, FILE *stream);

ОПИСАНИЕ

       Функция  fgetc()  считывает  очередной  символ из потока stream и возвращает unsigned char
       преобразованный в int, или EOF при достижении конца файла или при возникновении ошибки.

       Функция getc() похожа на fgetc(), но  она  может  быть  реализована  как  макрос,  который
       определяет состояние stream более одного раза.

       Функция getchar() эквивалентна getc(stdin).

       Функция  fgets() считывает максимум size -1 символов из stream и записывает их в буфер, на
       который указывает s. Чтение прерывается по достижении EOF или символа новой  строки.  Если
       получен  символ  новой  строки,  то  он заносится в буфер. В конец буфера после последнего
       символа добавляется завершающий байт null ('\0').

       Функция ungetc() заносит c обратно  в  stream,  преобразует  в  unsigned  char,  если  это
       возможно  для  дальнейших операций чтения. Занесённые обратно символы будут возвращаться в
       обратном порядке; гарантируется только одно занесение символов.

       Вызовы функций, описанные здесь, могут смешиваться друг с другом  и  с  другими  функциями
       ввода из библиотеки stdio для того же потока ввода.

       Для неблокирующих аналогов, см. unlocked_stdio(3).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       fgetc(),  getc(),  and getchar()  return the character read as an unsigned char cast to an
       int or EOF on end of file or error.

       Функция fgets() возвращает s при удачном выполнении и NULL при ошибке или  если  достигнут
       конец файла, а символы остались несчитанными.

       При успешном выполнении функция ungetc() возвращает c или EOF при ошибке.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).

       ┌───────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │Интерфейс                                              │ Атрибут              │ Значение │
       ├───────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │fgetc(), fgets(), getc(), getchar(), ungetc()          │ Безвредность в нитях │ MT-Safe  │
       └───────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

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

       Не  рекомендуется  чередовать  вызовы  функций  ввода  библиотеки  stdio с низкоуровневыми
       вызовами read(2) для дескриптора файла, связанного с потоком ввода; результат этого  будет
       неопределённым и, скорее всего, не тем, который ожидается.

СМ. ТАКЖЕ

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

ПЕРЕВОД

       Русский    перевод    этой    страницы    руководства    был    сделан   Azamat   Hackimov
       <azamat.hackimov@gmail.com>,  Dmitry  Bolkhovskikh  <d20052005@yandex.ru>,   Yuri   Kozlov
       <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

       Этот  перевод  является  бесплатной  документацией;  прочитайте  Стандартную  общественную
       лицензию GNU версии 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если  вы  обнаружите  ошибки  в  переводе этой страницы руководства, пожалуйста, отправьте
       электронное письмо на ⟨man-pages-ru-talks@lists.sourceforge.net⟩.