f_gets 从文件中读取一个字符串。

char* f_gets (   
    char* Str, /* 读缓冲区 */   
    int Size, /* 读缓冲区大小 */   
    FIL* FileObject /* 文件对象 */  
);

参数：

Str 存储读取字符串的读缓冲区指针。 

Size 读缓冲区大小。 

FileObject 打开的文件对象结构指针。 

返回值：

当函数成功后，Str 将被返回。 

描述：

f_gets 函数当_USE_STRFUNC == 1 或者_USE_STRFUNC == 2 时可用。如果_USE_STRFUNC == 2，文 件中包含的'\r'则被去除。 f_gets 函数是 f_read 的一个封装函数。当读取到'\n'、文件结束或缓冲区被填冲了 Size - 1 个字符时，读 操作结束。读取的字符串以'\0'结束。当文件结束或读操作中发生了任何错误，f_gets()返回一个空字符串。 可以使用宏 f_eof()和 f_error()检查 EOF 和错误状态。