f_gets

f_gets

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

TCHAR* f_gets (
  TCHAR* buff, /* [输出] 读取缓冲区 */
  int len,     /* [输入] 读取缓冲区的大小 */
  FIL* fp      /* [输入] 文件对象 */
);

参数

• buff: 指向用于存储读取的字符串的读取缓冲区的指针。
• len: 读取缓冲区的大小，单位为项。
• fp: 指向已打开的文件对象结构的指针。

返回值

当函数成功时，将返回 buff。当没有字符可读或在读取操作期间发生任何错误时，它返回一个空指针。

描述

读取操作会一直持续，直到存储了一个 \n，到达文件末尾，或者缓冲区被 len - 1 个字符填满。读取的字符串以 \0 结尾。

快速信息

当 FF_USE_STRFUNC >= 1 时可用。

相关参考

f_open, f_read, f_putc, f_puts, f_printf, f_close, FIL

```