f_putc

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

int f_putc (
  TCHAR Chr,        /* 書き込む文字 */
  FIL* FileObject   /* ファイル・オブジェクト */
);

引数

Chr
書き込む文字を指定します。
FileObject
ファイル・オブジェクト構造体へのポインタを指定します。

戻り値

文字が正常に書き込まれると書き込んだ文字数(1)が返されます。ディスクが満杯またはエラーにより書き込まれなかったときはEOF (-1)が返されます。

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

解説

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

対応情報

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

参照

f_open, f_puts, f_printf, f_gets, f_close, FIL

戻る