## f_gets

The f_gets reads a string from the file.

    char* f_gets (
      char* Str,        /* Read buffer */
      int Size,         /* Size of the read buffer */
      FIL* FileObject   /* File object */
    );

#### Parameters

Str
  Pointer to read buffer to store the read string.
Size
  Size of the read buffer.
FileObject
  Pointer to the open file object structure.

#### Return Values

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

#### Description

The f_gets() is a wrapper function of f_read(). The read operation continues until a `'\n'` is stored, reached end of file or buffer is filled with Size - 1 characters. The read string is terminated with a `'\0'`. When the file has reached end of the file or any error occured during read operation, f_gets() returns a `NULL`. The EOF and error status can be examined with `f_eof()` and `f_error()` macro.

This function is available when `_USE_STRFUNC` is 1 or 2. When it is set to 2, `'\r'` contained in the file is stripped.

#### References

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

Return