## f_puts

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

    int f_puts (
      const TCHAR* str,  /* [IN] 書き込む文字列 */
      FIL* fp            /* [IN] ファイル・オブジェクト */
    );

#### 引数

str
  書き込むヌル文字`'\0'`終端の文字列を指すポインタを指定します。ヌル文字は書き込まれません。
fp
  ファイル・オブジェクト構造体へのポインタを指定します。

#### 戻り値

文字列が正常に書き込まれると、書き込まれた文字数が返されます。ディスクが満杯またはエラーにより書き込みが中断されたときは`EOF (-1)`が返されます。

APIにUnicodeが選択(`_LFN_UNICODE`が1)されているときは、strはUTF-16文字列になりますが、ファイル上のエンコードは、`_STRF_ENCODE`オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で書き込みます。

#### 解説

文字列をファイルに書き込みます。この関数は`f_write()`のラッパー関数です。

#### 対応情報

`_FS_READONLY == 0`で、且つ`_USE_STRFUNC`が 1または 2のとき使用可能です。2を指定すると、文字列に含まれる`'\n'`は`"\r\n"`に展開されてファイルに書き込まれます。

#### 参照

`f_open, f_putc, f_printf, f_gets, f_close, FIL`

戻る