## f_write

ファイルにデータを書き込みます。

    FRESULT f_write (
      FIL* FileObject,     /* ファイル・オブジェクト */
      const void* Buffer,  /* 書き込みデータ */
      WORD ByteToWrite,    /* 書き込むバイト数 */
      WORD* ByteWritten    /* 書き込まれたバイト数 */
    );

#### 引数

FileObject
  ファイル・オブジェクト構造体へのポインタを指定します。
Buffer
  書き込むデータを格納したバッファを指すポインタを指定します。
ByteToWrite
  書き込むバイト数(0〜65535)を指定します。
ByteWritten
  書き込まれたバイト数を格納する変数を指すポインタを指定します。

#### 戻り値

FR_OK (0)
  正常終了。
FR_DENIED
  非書き込みモードで開いたファイルに書き込もうとした。
FR_RW_ERROR
  ディスク・エラーまたは内部エラーによる失敗。
FR_NOT_READY
  メディアがセットされていないなど、ディスク・ドライブが動作不能状態。
FR_INVALID_OBJECT
  無効なファイルオブジェクト。

#### 解説

書き込み開始位置は、ファイルR/Wポインタの現在位置からになります。ファイルR/Wポインタは実際に書き込まれたバイト数だけ進みます。書き込み中にディスクが一杯になったときは、`*ByteWritten`は`ByteToWrite`よりも小さくなります。リード・オンリー構成ではこの関数はサポートされません。

#### 参照

`f_open, f_read, f_close, FIL`

戻る