f_sync

書き込み中のファイルのキャッシュされた情報をフラッシュします。

FRESULT f_sync (
  FIL* FileObject     // ファイルオブジェクト構造体へのポインタ
);

パラメータ

FileObject
syncするファイルオブジェクト構造体へのポインタを指定します。

戻り値

FR_OK
正常終了。
FR_RW_ERROR
ディスクアクセスでエラーが発生した。
FR_INCORRECT_DISK_CHANGE
不正なメディアの取り外しがあった。ファイルを開いたままのメディア交換など。
FR_NOT_ENABLED
FatFsモジュールが停止状態。

解説

書き込み中のファイルのそこまでの状態（R/Wバッファ上のデータ、変更されたFATやディレクトリ項目）をディスクに書き込みます。この関数はファイルクローズのプロセスを実行しますが、ファイルは引き続き開かれたままになり、読み書きを続行できます。ロギングなど、書き込みモードで長時間ファイルが開かれているアプリケーションにおいて、定期的または区切りの良いところでsyncすることにより、不意の電源断やメディアの取り外しにより失われるデータを最小限にします。

リードオンリー構成ではこの関数はサポートされません。

参照

f_close

戻る