f_close

ファイルを閉じます。

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

引数

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

戻り値

FR_OK, FR_DISK_ERR, FR_INT_ERR, FR_NOT_READY, FR_INVALID_OBJECT, FR_TIMEOUT

解説

ファイルを閉じます。何らかの書き込みの行われたファイルの場合、キャッシュされた状態(リード/ライト・バッファ上のデータ、変更されたFATやディレクトリ項目)はディスクに書き戻されます。関数が正常終了すると、そのファイル・オブジェクトは無効になり、そのメモリも解放できます。

ファイル・オブジェクトが読み出し専用モードで、_FS_LOCKオプションが選択されていない場合は、ファイルを閉じずにファイル・オブジェクトを破棄することもできます。しかし、これは将来の互換性の点で推奨はされません。

対応情報

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

参照

f_open, f_read, f_write, f_sync, FIL, FATFS

戻る