fgets（）函数详解

Posted 2020-09-03

  功能

      从文件结构体指针stream中读取数据，每次读取一行。读取的数据保存在buf指向的字符数组中，每次最多读取bufsize-1个字符(第bufsize个字符赋‘\0‘)，如果文件中的该行，不足bufsize个字符，则读完该行就结束。如若该行(包括最后一个换行符)的字符数超过bufsize-1，则fgets只返回一个不完整的行，但是，缓冲区总是以NULL字符结尾，对fgets的下一次调用会继续读该行。函数成功将返回buf，失败或读到文件结尾返回NULL。因此我们不能直接通过fgets的返回值来判断函数是否是出错而终止的，应该借助feof函数或者ferror函数来判断

    函数原型

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

     *buf:字符型指针，指向用来存储所得数据的地址。

bufsize: 整型数据，指明存储数据的大小。

*stream: 文件结构体指针，将要读取的文件流。

stream文件流指针体指向文件内容地址的偏移原则

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

例子

如果一个文件的当前位置的文本如下

Love, I Have

Since you can do it.

如果用fgets(str1,6,file1);去读取

则执行后str1 = "Love," ，读取了6-1=5个字符

这个时候再执行fgets(str1,20,file1)则执行后str1 = " I Have\n"

而如果

fgets(str1,23,file1);

则执行str1="Love ,I Have"，读取了一行(包括行尾的‘\n‘,并自动加上字符串结束符‘\0‘)，当前文件位置移至下一行，虽然23大于当前行上字符总和，可是不会继续到下一行。而下一次调用fgets()继续读取的时候是从下一行开始读。

从 handle 指向的文件中读取一行并返回长度最多为 length - 1 字节的字符串。碰到换行符(包括在返回值中)、EOF 或者已经读取了 length - 1 字节后停止(看先碰到那一种情况)。如果没有指定 length，则默认为 1K，或者说 1024 字节。

出错时返回 FALSE。