]> cloudbase.mooo.com Git - z180-stamp.git/blobdiff - fatfs/doc/ja/printf.html
Merge branch 'chan-fatfs' into fatfs-integration
[z180-stamp.git] / fatfs / doc / ja / printf.html
index b5c22e078ccd46ffd62c8048f2e9554294376242..6e3a3f8feb58117497f849b015f5c6ae3be9bc8f 100644 (file)
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r
 <html lang="ja">\r
 <head>\r
-<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">\r
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">\r
 <meta http-equiv="Content-Style-Type" content="text/css">\r
 <link rel="up" title="FatFs" href="../00index_j.html">\r
 <link rel="alternate" hreflang="en" title="English" href="../en/printf.html">\r
 \r
 <div class="para func">\r
 <h2>f_printf</h2>\r
-<p>\83t\83@\83C\83\8b\82É\8f\91\8e®\89»\95\8e\9a\97ñ\82ð\8f\91\82«\8d\9e\82Ý\82Ü\82·\81B</p>\r
+<p>ファイルに書式化文字列を書き込みます。</p>\r
 <pre>\r
 int f_printf (\r
-  FIL* <span class="arg">fp</span>,           <span class="c">/* [IN] \83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g */</span>\r
-  const TCHAR* <span class="arg">fmt</span>,  <span class="c">/* [IN] \8f\91\8e®\90§\8cä\95\8e\9a\97ñ */</span>\r
+  FIL* <span class="arg">fp</span>,           <span class="c">/* [IN] ファイル オブジェクト */</span>\r
+  const TCHAR* <span class="arg">fmt</span>,  <span class="c">/* [IN] 書式制御文字列 */</span>\r
   ...\r
 );\r
 </pre>\r
 </div>\r
 \r
 <div class="para arg">\r
-<h4>\88ø\90\94</h4>\r
+<h4>引数</h4>\r
 <dl class="par">\r
 <dt>fp</dt>\r
-<dd>\83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g\8d\\91¢\91Ì\82Ö\82Ì\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ü\82·\81B</dd>\r
+<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd>\r
 <dt>fmt</dt>\r
-<dd>\83k\83\8b\95\8e\9a<tt>'\0'</tt>\8fI\92[\82Ì\8f\91\8e®\90§\8cä\95\8e\9a\97ñ\82ð\8ew\82·\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ü\82·\81B\83k\83\8b\95\8e\9a\82Í\8f\91\82«\8d\9e\82Ü\82ê\82Ü\82¹\82ñ\81B</dd>\r
+<dd>ヌル文字<tt>'\0'</tt>終端の書式制御文字列を指すポインタを指定します。ヌル文字は書き込まれません。</dd>\r
 <dt>...</dt>\r
-<dd>\83I\83v\83V\83\87\83\93\82Ì\88ø\90\94\81B</dd>\r
+<dd>オプションの引数。</dd>\r
 \r
 </dl>\r
 </div>\r
 \r
 \r
 <div class="para ret">\r
-<h4>\96ß\82è\92l</h4>\r
-<p>\95\8e\9a\97ñ\82ª\90³\8fí\82É\8f\91\82«\8d\9e\82Ü\82ê\82é\82Æ\81A\8f\91\82«\8d\9e\82Ü\82ê\82½\95\8e\9a\90\94\82ª\95Ô\82³\82ê\82Ü\82·\81B\83f\83B\83X\83N\82ª\96\9e\94t\82Ü\82½\82Í\82»\82Ì\91¼\83G\83\89\81[\82É\82æ\82è\90³\8fí\82É\8f\91\82«\8d\9e\82Ü\82ê\82È\82©\82Á\82½\82Æ\82«\82Í\81A\8aÖ\90\94\82Í\8e¸\94s\82µ<tt>EOF (-1)</tt>\82ª\95Ô\82³\82ê\82Ü\82·\81B</p>\r
+<h4>戻り値</h4>\r
+<p>文字列が正常に書き込まれると、書き込まれた文字数が返されます。ディスクが満杯またはその他エラーにより正常に書き込まれなかったときは、関数は失敗し<tt>EOF (-1)</tt>が返されます。</p>\r
 </div>\r
 \r
 \r
 <div class="para desc">\r
-<h4>\89ð\90à</h4>\r
-<p>\82±\82Ì\8aÖ\90\94\82Í\81A<a href="putc.html"><tt>f_putc()</tt></a>\82¨\82æ\82Ñ<a href="puts.html"><tt>f_puts()</tt></a>\82Ì\83\89\83b\83p\81[\8aÖ\90\94\82Å\82·\81B\8f\91\8e®\90§\8cä\8b@\94\\82ÍC\95W\8f\80\83\89\83C\83u\83\89\83\8a\82Ì\83T\83u\83Z\83b\83g\82Æ\82È\82Á\82Ä\82¢\82Ä\81A\8f\91\8e®\90§\8cä\95\8e\9a\82Í\8e\9f\82É\8e¦\82·\82à\82Ì\82ª\8eg\97p\89Â\94\\82Å\82·\81B</p>\r
+<h4>解説</h4>\r
+<p>書式制御機能はC標準ライブラリのサブセットとなっていて、書式制御文字は次に示すものが使用可能です。</p>\r
 <ul>\r
-<li>\83^\83C\83v: <tt>c C s S d D u U x X b B</tt></li>\r
-<li>\90¸\93x\8ew\92è: <tt>l L</tt></li>\r
-<li>\83t\83\89\83O: <tt>0 -</tt></li>\r
+<li>タイプ: <tt>c C s S d D u U x X b B</tt></li>\r
+<li>精度指定: <tt>l L</tt></li>\r
+<li>フラグ: <tt>0 -</tt></li>\r
 </ul>\r
 </div>\r
 \r
 \r
 <div class="para comp">\r
-<h4>\91Î\89\9e\8fî\95ñ</h4>\r
-<p><tt>_FS_READONLY == 0</tt>\82Å\81A\8a\8e\82Â<tt>_USE_STRFUNC</tt>\82ª1\82Ü\82½\82Í2\82Ì\82Æ\82«\8eg\97p\89Â\94\\82É\82È\82è\82Ü\82·\81B2\82Ì\8e\9e\82Í\81A\8fo\97Í\82É\8aÜ\82Ü\82ê\82é<tt>'\n'</tt>\82ª<tt>'\r'+'\n'</tt>\82É\93W\8aJ\82³\82ê\82Ä\83t\83@\83C\83\8b\82É\8f\91\82«\8d\9e\82Ü\82ê\82Ü\82·\81B</p>\r
-<p>API\82ÉUnicode\82ª\91I\91ð(<tt>_LFN_UNICODE</tt>\82ª1)\82³\82ê\82Ä\82¢\82é\82Æ\82«\82Í\81A<tt class="arg">fmt</tt>\82ÍUnicode\95\8e\9a\97ñ\82É\82È\82è\82Ü\82·\82ª\81A\83t\83@\83C\83\8b\8fã\82Ì\83G\83\93\83R\81[\83h\82Í\81A<tt>_STRF_ENCODE</tt>\83I\83v\83V\83\87\83\93\82Å\91I\91ð\82Å\82«\82Ü\82·\81B\82»\82ê\88È\8aO\82Ì\8e\9e\82Í\96³\95Ï\8a·(1\83o\83C\83g/1\95\8e\9a)\82Å\8f\91\82«\8d\9e\82Ý\82Ü\82·\81B</p>\r
+<h4>対応情報</h4>\r
+<p>この関数は、<a href="putc.html"><tt>f_putc</tt></a>関数および<a href="puts.html"><tt>f_puts</tt></a>関数のラッパー関数です。<tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_STRFUNC</tt>が1または2のとき使用可能になります。2の時は、出力に含まれる<tt>'\n'</tt>が<tt>'\r'+'\n'</tt>に展開されてファイルに書き込まれます。</p>\r
+<p>APIにUnicodeが選択(<tt>_LFN_UNICODE</tt>が1)されているときは、<tt class="arg">fmt</tt>はUnicode文字列になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で書き込みます。</p>\r
 </div>\r
 \r
 \r
 <div class="para use">\r
-<h4>\8eg\97p\97á</h4>\r
+<h4>使用例</h4>\r
 <pre>\r
     f_printf(&amp;fil, "%d", 1234);            <span class="c">/* "1234" */</span>\r
     f_printf(&amp;fil, "%6d,%3d%%", -200, 5);  <span class="c">/* "  -200,  5%" */</span>\r
@@ -78,16 +78,16 @@ int f_printf (
     f_printf(&amp;fil, "%8s", "abc");          <span class="c">/* "     abc" */</span>\r
     f_printf(&amp;fil, "%-8s", "abc");         <span class="c">/* "abc     " */</span>\r
     f_printf(&amp;fil, "%c", 'a');             <span class="c">/* "a" */</span>\r
-    f_printf(&amp;fil, "%f", 10.0);            <span class="c">/* \95\82\93®\8f¬\90\94\93_\82Í\96¢\83T\83|\81[\83g */</span>\r
+    f_printf(&amp;fil, "%f", 10.0);            <span class="c">/* 浮動小数点は未サポート */</span>\r
 </pre>\r
 </div>\r
 \r
 \r
 <div class="para ref">\r
-<h4>\8eQ\8fÆ</h4>\r
+<h4>参照</h4>\r
 <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>\r
 </div>\r
 \r
-<p class="foot"><a href="../00index_j.html">\96ß\82é</a></p>\r
+<p class="foot"><a href="../00index_j.html">戻る</a></p>\r
 </body>\r
 </html>\r