## f_gets

The f_gets reads a string from the file.

    TCHAR* f_gets (
      TCHAR* buff, /* [OUT] Read buffer */
      int len,     /* [IN] Size of the read buffer */
      FIL* fp      /* [IN] File object */
    );

#### Parameters

buff
  Pointer to read buffer to store the read string.
len
  Size of the read buffer in unit of item.
fp
  Pointer to the open file object structure.

#### Return Values

When the function succeeded, `buff` will be returuned.

#### Description

The read operation continues until a `'\n'` is stored, reached end of the file or the buffer is filled with `len - 1` characters. The read string is terminated with a `'\0'`. When no character to read or any error occured during read operation, it returns a null pointer. The status of EOF and error can be examined with `f_eof` and `f_error` function.

When FatFs is configured to Unicode API (`FF_LFN_UNICODE >= 1`), data types on the srting fuctions, `f_putc`, `f_puts`, `f_printf` and `f_gets`, is also switched to Unicode. The character encoding on the file to be read via this function is assumed as `FF_STRF_ENCODE`. If the character encoding differs between file data and API, it is converted in this function. Input characters with wrong encoding for output will be lost.

#### QuickInfo

This is a wrapper function of `f_read` function. Available when `FF_USE_STRFUNC >= 1`. When it is set to 2, `'\r'`s contained in the read data are stripped off.

#### See Also

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

Return