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’),文件并不会继续读下去,仅仅只是这一行读取完,随后指向文件的指针会自动偏移至下一行。
int feof(FILE *stream);
功能
feof是检测流上的文件结束符,如果文件结束,则返回非0值,否则返回0,文件结束符只能被clearerr()清除。
int ferror(FILE *stream);
功能
在调用各种输入输出函数(如 putc.getc.fread.fwrite等)时,如果出现错误,除了函数返回值有所反映外,还可以用ferror函数检查。如果ferror返回值为0,表示未出错。如果返回一个非零值,表示出错。
对同一个文件每一次调用输入输出函数,均产生一个新的ferror函数值,因此,应当在调用一个输入输出函数后立即检查ferror函数的值,否则信息会丢失。在执行fopen函数时,ferror函数的初始值自动置为0。
例子
int main(void) {
char line[256];
FILE *f = fopen("1/2.txt", "rb");
while (!feof(f)) {
fgets(line, sizeof(line), f);
printf("-%s", line);
}
fclose(f);
return 0;
}
1.txt:
2.txt:
原因:
fgets在读取了sizeof(line)-1个字符、读到了’\n’或遇到了EOF三种情况之一时都结束读取。 2.txt多余的一行打印,是因为2.txt最后一行只有一个’\n’,fget读一个字节立即正常结束读取,此种情况下未更新line内容导致。
改进:
推荐写法:
int main(void) {
char line[256];
FILE *f = fopen("2.txt", "rb");
while (!feof(f) && !ferror(f)) {
strcpy(line, "\n");
fgets(line, sizeof(line), f);
printf("-%s", line);
}
fclose(f);
return 0;
}