f_truncate

ファイル長を切り詰めます。

FRESULT f_truncate (
  FIL* FileObject     /* ファイル・オブジェクトへのポインタ */
);

引数

FileObject

切り詰め対象ファイルのファイル・オブジェクトへのポインタ

戻り値

FR_OK (0)

正常終了。

FR_DENIED

ファイルが非書き込みモードで開かれている。

FR_DISK_ERR

ディスク・エラーによる失敗。

FR_INT_ERR

不正なFAT構造または内部エラーによる失敗。

FR_NOT_READY

メディアがセットされていないなど、物理ドライブが動作不能状態。

FR_INVALID_OBJECT

無効なファイル・オブジェクト。

解説

ファイルの長さが現在のファイルR/Wポインタに切り詰められます。ファイルR/Wポインタがファイルの終端を指しているときは、この関数は何の効果も持ちません。

対応情報

_FS_READONLY == 0で、且つ_FS_MINIMIZE == 0のときに使用可能です。

参照

f_open, f_lseek, FIL