fgets

Считывает не более count - 1 символов из заданного файлового потока и сохраняет их в массиве символов, на который указывает str . Разбор прекращается, если встречается символ новой строки (в этом случае str будет содержать этот символ новой строки) или при достижении конца файла. Если байты считаны и ошибок не произошло, записывает нулевой символ в позицию сразу после последнего записанного символа в str .

Параметры

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

str при успехе, нулевой указатель при неудаче.

Если встречается условие конца файла, устанавливает индикатор eof на stream (см. feof() ). Это считается ошибкой только если не было прочитано ни одного байта, в этом случае возвращается нулевой указатель и содержимое массива, на который указывает str не изменяется (т.е. первый байт не перезаписывается нулевым символом).

Если сбой был вызван какой-либо другой ошибкой, устанавливает индикатор ошибки (см. ferror() ) на stream . Содержимое массива, на который указывает str , является неопределённым (он может даже не быть нуль-терминированным).

Примечания

POSIX дополнительно требует , чтобы fgets устанавливал errno при возникновении ошибки чтения.

Хотя стандартная спецификация неясна в случаях, когда count <= 1 , распространённые реализации

• если count < 1 , ничего не делать, сообщить об ошибке,
• если count == 1 ,

• некоторые реализации ничего не делают, сообщают об ошибке,
• другие ничего не читают, сохраняют ноль в str [ 0 ] , сообщают об успехе.

Пример

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    FILE* tmpf = tmpfile();
    fputs("Alan Turing\n", tmpf);
    fputs("John von Neumann\n", tmpf);
    fputs("Alonzo Church\n", tmpf);
    rewind(tmpf);
    char buf[8];
    while (fgets(buf, sizeof buf, tmpf) != NULL)
          printf("\"%s\"\n", buf);
    if (feof(tmpf))
       puts("End of file reached");
}

"Alan Tu"
"ring
"
"John vo"
"n Neuma"
"nn
"
"Alonzo "
"Church
"
End of file reached

Ссылки

Смотрите также