## f_truncate

The f_truncate function truncates the file size.

    FRESULT f_truncate (
      FIL* FileObject     /* Pointer to the file object */
    );

#### Parameter

FileObject
  Pointer to the open file object to be truncated.

#### Return Values

FR_OK (0)
  The function succeeded.
FR_DENIED
  The file has been opened in read-only mode.
FR_DISK_ERR
  The function failed due to an error in the disk function.
FR_INT_ERR
  The function failed due to a wrong FAT structure or an internal error.
FR_NOT_READY
  The disk drive cannot work due to no medium in the drive or any other reason.
FR_INVALID_OBJECT
  The file object is invalid.

#### Description

The f_truncate function truncates the file size to the current file read/write point. This function has no effect if the file read/write pointer is already pointing end of the file.

#### QuickInfo

Available when `_FS_READONLY == 0` and `_FS_MINIMIZE == 0`.

#### See Also

`f_open, f_lseek, FIL`

Return