fgets

char* fgets( char* str, int count, FILE* stream );

char* fgets( char* restrict str, int count, FILE* restrict stream );

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

Параметры

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

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

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

Если неудача вызвана другой ошибкой, устанавливается индикатор error (см. 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

Ссылки

См. также