fgets
  получает строку символов из потока  

Синтаксис
 
    #include <stdio.h> 

    char *fgets(char *string, int n, FILE *stream);

Параметры
  string память для хранения данных
  n число сохраняемых символов
  stream указатель на структуру FILE

Описание
  fgets читает строку из входного потока stream и помещает ее в string. Символы считываются, начиная с текущей позиции stream, до символа новой строки '\n' или до конца потока, либо пока число считанных символов не станет равным n-1. Результат размещается в string, а затем к нему добавляется символ null -'\0'. Символ новой строки также включается в string. Если в начале считывания n равнялось 1, то string будет пустой ("").

Возвращаемое значение
  fgets возвращает указатель на строку string. В случае ошибки или конца файла возвращается значение NULL. Для определения того, что произошло - ошибка или конец файла, используются функции feof и ferror.


Список системных вызовов