GETS(3S)                                               GETS(3S)
НАЗВАНИЕ
gets, fgets - чтение цепочки символов из потока
СИНТАКСИС
       |#include <stdio.h>
       |
       |char *gets (s)
       |char *s;
       |
       |char *fgets (s, n, stream)
       |char *s;
       |int n;
       |FILE *stream;
ОПИСАНИЕ
Функция gets читает символы из стандартного потока вво-
        да stdin в область памяти, на которую  указывает  аргу-
        мент  s. Чтение производится до тех пор, пока не встре-
        тится перевод строки или конец файла.  Символ  перевода
        строки отбрасывается, а прочитанная цепочка ограничива-
        ется нулевым байтом.
        Функция  fgets считывает символы из потока ввода stream
        и пересылает их в область памяти, на которую  указывает
        аргумент  s.  Функция завершает работу, ограничивая це-
        почку s нулевым байтом, когда она или  переслала  (n-1)
        символов, или переслала символ перевода строки (в отли-
        чие  от  gets он не отбрасывается), или встретила конец
        файла.            
        
СМ. ТАКЖЕ             
        ferror(3S), fopen(3S), fread(3S), getc(3S),  scanf(3S),
        stdio(3S).
                                  
ДИАГНОСТИКА     
        Если первым прочитанным символом окажется признак конца
        файла,  то  есть  фактически ни одного символа не будет
        считано, то обе  функции  возвращают  пустой  указатель
        NULL.  Если обнаружена ошибка чтения, например, при по-
        пытке использовать эти функции для файлов, не  открытых
        на чтение, то также возвращается NULL. В остальных сл
        чаях возвращается значение указателя s.