f_close

ファイルを閉じます。

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

引数

FileObject
閉じようとするファイルのファイル・オブジェクト構造体へのポインタを指定します。

戻り値

FR_OK (0)
正常終了。
FR_DISK_ERR
ディスク・エラーによる失敗。
FR_INT_ERR
不正なFAT構造または内部エラーによる失敗。
FR_NOT_READY
メディアがセットされていないなど、ディスク・ドライブが動作不能状態。
FR_INVALID_OBJECT
無効なファイル・オブジェクト。

解説

ファイルを閉じます。書き込みの行われたファイルの場合、キャッシュされた状態（R/Wバッファ上のデータ、変更されたFATやディレクトリ項目）はディスクに書き戻されます。関数が正常終了すると、そのファイル・オブジェクトは無効になり、そのメモリも解放できます。読み込み専用モードで開かれたファイル・オブジェクトは、この関数によるクローズ処理を経ずに破棄することもできます。

対応情報

全ての構成で使用可能です。

参照

f_open, f_read, f_write, f_sync, FIL, FATFS

戻る