Описание функций C (Си) / C++ - fgets

#include
char *fgets(string, n, stream);читает строку из потока
stream.
char *string; память для хранения данных.
int n; число сохраняемых символов.
FILE *stream; указатель на структуру FILE.

Описание.

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

Возвращаемое значение.

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

Пример:

include
FILE *stream;
char line[100], *result;
/* следующий оператор выбирает строку символов из потока
stream. Может быть считано не более 99 символов либо все символы
до символа новой строки 'n', включая и его. */
result = fgets(line, 100, stream);.