1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta http-equiv=
"Content-Type" content=
"text/html; charset=utf-8">
5 <meta http-equiv=
"Content-Style-Type" content=
"text/css">
6 <link rel=
"up" title=
"FatFs" href=
"../00index_j.html">
7 <link rel=
"alternate" hreflang=
"en" title=
"English" href=
"../en/printf.html">
8 <link rel=
"stylesheet" href=
"../css_j.css" type=
"text/css" media=
"screen" title=
"ELM Default">
9 <title>FatFs - f_printf
</title>
14 <div class=
"para func">
16 <p>ファイルに書式化文字列を書き込みます。
</p>
19 FIL*
<span class=
"arg">fp
</span>,
<span class=
"c">/* [IN] ファイル オブジェクト */
</span>
20 const TCHAR*
<span class=
"arg">fmt
</span>,
<span class=
"c">/* [IN] 書式制御文字列 */
</span>
26 <div class=
"para arg">
30 <dd>ファイル オブジェクト構造体へのポインタを指定します。
</dd>
32 <dd>ヌル文字
<tt>'\
0'
</tt>終端の書式制御文字列を指すポインタを指定します。ヌル文字は書き込まれません。
</dd>
40 <div class=
"para ret">
42 <p>文字列が正常に書き込まれると、書き込まれた文字数が返されます。ディスクが満杯またはその他エラーにより正常に書き込まれなかったときは、関数は失敗し
<tt>EOF (-
1)
</tt>が返されます。
</p>
46 <div class=
"para desc">
48 <p>この関数は、
<a href=
"putc.html"><tt>f_putc()
</tt></a>および
<a href=
"puts.html"><tt>f_puts()
</tt></a>のラッパー関数です。書式制御機能はC標準ライブラリのサブセットとなっていて、書式制御文字は次に示すものが使用可能です。
</p>
50 <li>タイプ:
<tt>c C s S d D u U x X b B
</tt></li>
51 <li>精度指定:
<tt>l L
</tt></li>
52 <li>フラグ:
<tt>0 -
</tt></li>
57 <div class=
"para comp">
59 <p><tt>_FS_READONLY ==
0</tt>で、且つ
<tt>_USE_STRFUNC
</tt>が
1または
2のとき使用可能になります。
2の時は、出力に含まれる
<tt>'\n'
</tt>が
<tt>'\r'+'\n'
</tt>に展開されてファイルに書き込まれます。
</p>
60 <p>APIにUnicodeが選択(
<tt>_LFN_UNICODE
</tt>が
1)されているときは、
<tt class=
"arg">fmt
</tt>はUnicode文字列になりますが、ファイル上のエンコードは、
<tt>_STRF_ENCODE
</tt>オプションで選択できます。それ以外の時は無変換(
1バイト/
1文字)で書き込みます。
</p>
64 <div class=
"para use">
67 f_printf(
&fil,
"%d",
1234);
<span class=
"c">/*
"1234" */
</span>
68 f_printf(
&fil,
"%6d,%3d%%", -
200,
5);
<span class=
"c">/*
" -200, 5%" */
</span>
69 f_printf(
&fil,
"%ld",
12345L);
<span class=
"c">/*
"12345" */
</span>
70 f_printf(
&fil,
"%06d",
25);
<span class=
"c">/*
"000025" */
</span>
71 f_printf(
&fil,
"%06d", -
25);
<span class=
"c">/*
"000-25" */
</span>
72 f_printf(
&fil,
"%-6d",
25);
<span class=
"c">/*
"25 " */
</span>
73 f_printf(
&fil,
"%u", -
1);
<span class=
"c">/*
"65535" or
"4294967295" */
</span>
74 f_printf(
&fil,
"%04x",
0xAB3);
<span class=
"c">/*
"0ab3" */
</span>
75 f_printf(
&fil,
"%08LX",
0x123ABCL);
<span class=
"c">/*
"00123ABC" */
</span>
76 f_printf(
&fil,
"%016b",
0x550F);
<span class=
"c">/*
"0101010100001111" */
</span>
77 f_printf(
&fil,
"%s",
"String");
<span class=
"c">/*
"String" */
</span>
78 f_printf(
&fil,
"%8s",
"abc");
<span class=
"c">/*
" abc" */
</span>
79 f_printf(
&fil,
"%-8s",
"abc");
<span class=
"c">/*
"abc " */
</span>
80 f_printf(
&fil,
"%c", 'a');
<span class=
"c">/*
"a" */
</span>
81 f_printf(
&fil,
"%f",
10.0);
<span class=
"c">/* 浮動小数点は未サポート */
</span>
86 <div class=
"para ref">
88 <p><tt><a href=
"open.html">f_open
</a>,
<a href=
"putc.html">f_putc
</a>,
<a href=
"puts.html">f_puts
</a>,
<a href=
"gets.html">f_gets
</a>,
<a href=
"close.html">f_close
</a>,
<a href=
"sfile.html">FIL
</a></tt></p>
91 <p class=
"foot"><a href=
"../00index_j.html">戻る
</a></p>