FatFs - f_sync

## f_sync

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

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

#### 引数

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

#### 戻り値

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

#### 解説

この関数は`f_close()`と同じ処理を実行しますが、ファイルは引き続き開かれたままになり、読み書きを続行できます。ロギングなど、書き込みモードで長時間ファイルが開かれているアプリケーションにおいて、定期的または区切りの良いところでsyncすることにより、不意の電源断やメディアの取り外しにより失われるデータを最小にすることができます。実際のところ、f_closeではsyncしたあとファイル・オブジェクトを破棄しているだけなので、f_close直前のsyncは意味がありません。

#### 対応情報

`_FS_READONLY == 0`のときに使用可能です。

#### 参照

`f_close`

戻る