FatFs - f_puts

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 戻る