fgets函数

函数功能
从指定的流中读取数据，每次读取一行。

函数原型

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

函数参数
str：指向一个字符数组的指针，该数组存储了要读取的字符串。
n：要读取的最大字符数（包括最后的空字符）。通常是使用以 str 传递的数组长度。
stream：这是指向 FILE 对象的指针，该 FILE 对象标识了要从中读取字符的流。

函数功能
从指定的流 stream 读取一行，并把它存储在str所指向的字符串内。当读取(n-1)个字符时，或者读取到换行符时，或者到达文件末尾时，它会停止，具体视情况而定。

使用说明
如果文件中的该行，不足n-1个字符，则读完该行就结束。
如若该行（包括最后一个换行符）的字符数超过n-1，则fgets只返回一个不完整的行，但是，缓冲区总是以NULL字符结尾，对fgets的下一次调用会继续读该行。
函数成功将返回stream，失败或读到文件结尾返回NULL。因此不能直接通过fgets的返回值来判断函数是否是出错而终止的，应该借助feof函数或者ferror函数来判断。

函数返回值
如果成功，该函数返回相同的 str 参数。如果到达文件末尾或者没有读取到任何字符，str 的内容保持不变，并返回一个空指针。如果发生错误，返回一个空指针。
在读字符时遇到end-of-file，则eof指示器被设置，如果还没读入任何字符就遇到这种情况，则stream保持原来的内容，返回NULL；
如果发生读入错误，error指示器被设置，返回NULL，stream的值可能被改变。