C语言按行读取文件的正确使用：fgets、feof、ferror

转自

https://blog.csdn.net/yss28/article/details/53453959

一、fgets函数

原型

char *fgets(char *buf, int bufsize, FILE *stream);

功能

fgets函数用来从stream所指文件中读入bufsize-1个字符放入buf为起始地址的空间内；如果在未读满bufsize-1个字符之时，已读到一个换行符或一个EOF（文件结束标志），则结束本次读操作，读入的字符串中最后包含读到的换行符。因此，调用fgets函数时，最多只能读入bufsize-1个字符。读入结束后，系统将自动在最后加’\0’，并以buf作为函数值返回。

返回值

• 成功，则返回第一个参数buf；
• 在读字符时遇到end-of-file，则eof指示器被设置，如果还没读入任何字符就遇到这种情况，则buf保持原来的内容，返回NULL；
• 如果发生读入错误，error指示器被设置，返回NULL，buf的值可能被改变。

stream文件流指针体偏移原则

如果使用fgets()读取某个文件，第一次读取的bufsize为5，而文件的第一行有10个字符（算上’\n’），那么读取文件的指针会偏移至当前读取完的这个字符之后的位置。也就是第二次再用fgets()读取文件的时候，则会继续读取其后的字符。
如果使用fgets() 读取文件的时候bufsize大于该行的字符总数加2（多出来的两个，一个保存文件本身的’\n’换行，一个保存字符串本身的结束标识’\0’），文件并不会继续读下去，仅仅只是这一行读取完，随后指向文件的指针会自动偏移至下一行。

二、feof函数

原型

int feof(FILE *stream);

功能

feof是检测流上的文件结束符，如果文件结束，则返回非0值，否则返回0，文件结束符只能被clearerr()清除。

三、ferror

原型

int ferror(FILE *stream);

功能

在调用各种输入输出函数（如 putc.getc.fread.fwrite等）时，如果出现错误，除了函数返回值有所反映外，还可以用ferror函数检查。如果ferror返回值为0，表示未出错。如果返回一个非零值，表示出错。 
对同一个文件每一次调用输入输出函数，均产生一个新的ferror函数值，因此，应当在调用一个输入输出函数后立即检查ferror函数的值，否则信息会丢失。在执行fopen函数时，ferror函数的初始值自动置为0。
 

四、示例

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    char line[256];
    FILE *f = fopen("1.txt", "rb");
    while (!feof(f) && !ferror(f)) {
        strcpy(line, "\n"); 
        fgets(line, sizeof(line), f);
        printf("-%s", line);
    }
    fclose(f);
    return 0;
}

运行结果：