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=iso-8859-1">
5 <meta http-equiv=
"Content-Style-Type" content=
"text/css">
6 <link rel=
"up" title=
"FatFs" href=
"../00index_e.html">
7 <link rel=
"stylesheet" href=
"../css_e.css" type=
"text/css" media=
"screen" title=
"ELM Default">
8 <title>FatFs - f_printf
</title>
15 <p>The f_printf function writes formatted string to the file.
</p>
18 FIL*
<em>FileObject
</em>, /* File object */
19 const char*
<em>Foramt
</em>, /* Format stirng */
29 <dd>Pointer to the open file object structure.
</dd>
31 <dd>Pointer to the null-terminated format string.
</dd>
33 <dd>Optional arguments.
</dd>
40 <h4>Return Values
</h4>
41 <p>When the function succeeded, number of characters written is returned. When the function failed due to disk full or any error, an
<tt>EOF
</tt> will be returned.
</p>
47 <p>The f_printf() is a wrapper function of
<a href=
"putc.html">f_putc()
</a> and
<a href=
"puts.html">f_puts()
</a>. The format control directive is a sub-set of standard library shown as follos:
</p>
49 <li>Type:
<tt>c s d u X
</tt></li>
50 <li>Size:
<tt>l
</tt></li>
51 <li>Flag:
<tt>0</tt></li>
58 <p>Available when
<tt>_FS_READONLY ==
0</tt> and
<tt>_USE_STRFUNC
</tt> is
1 or
2. When it is set to
2,
<tt>'\n'
</tt>s contained in the output are converted to
<tt>"\r\n"</tt>.
</p>
65 f_printf(
&fil,
"%6d", -
200); /*
" -200" */
66 f_printf(
&fil,
"%02u",
5); /*
"05" */
67 f_printf(
&fil,
"%ld",
12345678L); /*
"12345678" */
68 f_printf(
&fil,
"%08lX",
1194684UL); /*
"00123ABC" */
69 f_printf(
&fil,
"%s",
"String"); /*
"String" */
70 f_printf(
&fil,
"%c", 'a'); /*
"a" */
77 <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>
80 <p class=
"foot"><a href=
"../00index_e.html">Return
</a></p>