## f_printf

ファイルに書式化文字列を書き込みます。

    int f_printf (
      FIL* FileObject,      /* ファイル・オブジェクト */
      const TCHAR* Foramt,  /* 書式制御文字列 */
      ...
    );

#### 引数

FileObject
  ファイル・オブジェクト構造体へのポインタを指定します。
Format
  '\0'で終わる書式制御文字列を指すポインタを指定します。'\0'は書き込まれません。
...
  オプションの引数。

#### 戻り値

文字列が正常に書き込まれると書き込まれた文字数が返されます。ディスクが満杯またはその他エラーにより正常に書き込まれなかったときは関数は失敗し`EOF (-1)`が返されます。

#### 解説

この関数はf_putc()およびf_puts()のラッパー関数です。書式制御機能はサブセットとなっていて、書式制御文字は次に示すものが使用可能です。

- タイプ: `c C s S d D u U x X b B`
- 精度指定: `l L`
- フラグ: `0`

#### 対応情報

`_FS_READONLY == 0`で、且つ`_USE_STRFUNC`が 1または 2のとき使用可能になります。2の時は、出力に含まれる`'\n'`が`"\r\n"`に展開されてファイルに書き込まれます。

APIにUnicodeが選択されている(`_LFN_UNICODE`が1)ときは、UTF-8エンコードでファイルに書き込みます。それ以外の時は無変換(1文字1バイト)で書き込みます。

#### 使用例

        f_printf(&fil, "%6d", -200);         /* "  -200" */
        f_printf(&fil, "%02u", 5);           /* "05" */
        f_printf(&fil, "%ld", 12345678L);    /* "12345678" */
        f_printf(&fil, "%08lX", 1194684UL);  /* "00123ABC" */
        f_printf(&fil, "%s", "String");      /* "String" */
        f_printf(&fil, "%c", 'a');           /* "a" */

#### 参照

`f_open, f_putc, f_puts, f_gets, f_close, FIL`

戻る