]> cloudbase.mooo.com Git - z180-stamp.git/blobdiff - fatfs/doc/ja/stat.html
Merge branch 'chan-fatfs' into fatfs-integration
[z180-stamp.git] / fatfs / doc / ja / stat.html
index 5337f348db5adfe62ebcecddd6ea8b4a8f30bf09..deba89b35b6a30e3c3ac57aa70c36ebeb52dd104 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/stat.html">\r
 \r
 <div class="para func">\r
 <h2>f_stat</h2>\r
-<p>\83t\83@\83C\83\8b\82Ü\82½\82Í\83T\83u\81E\83f\83B\83\8c\83N\83g\83\8a\82Ì\91\8dÝ\82ð\92²\82×\81A\82Ü\82½\82»\82Ì\8fî\95ñ\82ð\8eæ\93¾\82µ\82Ü\82·\81B</p>\r
+<p>ファイルまたはサブ ディレクトリの存在を調べ、またその情報を取得します。</p>\r
 <pre>\r
 FRESULT f_stat (\r
-  const TCHAR* <span class="arg">path</span>,  <span class="c">/* [IN] \83I\83u\83W\83F\83N\83g\96¼\82Ö\82Ì\83|\83C\83\93\83^ */</span>\r
-  FILINFO* <span class="arg">fno</span>        <span class="c">/* [OUT] \83t\83@\83C\83\8b\8fî\95ñ\8d\\91¢\91Ì\82Ö\82Ì\83|\83C\83\93\83^ */</span>\r
+  const TCHAR* <span class="arg">path</span>,  <span class="c">/* [IN] オブジェクト名へのポインタ */</span>\r
+  FILINFO* <span class="arg">fno</span>        <span class="c">/* [OUT] ファイル情報構造体へのポインタ */</span>\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>path</dt>\r
-<dd>\83`\83F\83b\83N\82·\82é\83I\83u\83W\83F\83N\83g\96¼\82ð\8e¦\82·\83k\83\8b\95\8e\9a<tt>'\0'</tt>\8fI\92[\82Ì\95\8e\9a\97ñ\82ð\8ew\82·\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ü\82·\81B</dd>\r
+<dd>チェックするオブジェクト名を示すヌル文字<tt>'\0'</tt>終端の文字列を指すポインタを指定します。</dd>\r
 <dt>fno</dt>\r
-<dd>\83I\83u\83W\83F\83N\83g\82ª\91\8dÝ\82µ\82½\82Æ\82«\82É\82»\82Ì\8fî\95ñ\82ð\8ai\94[\82·\82é\83t\83@\83C\83\8b\8fî\95ñ\8d\\91¢\91Ì\82Ö\82Ì\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ü\82·\81B\82±\82Ì\8fî\95ñ\82ª\95s\97v\82È\82Æ\82«\82Í\83k\83\8b\81E\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ä\82­\82¾\82³\82¢\81B</dd>\r
+<dd>オブジェクトが存在したときにその情報を格納するファイル情報構造体へのポインタを指定します。この情報が不要なときはヌル ポインタを指定してください。</dd>\r
 </dl>\r
 </div>\r
 \r
 \r
 <div class="para ret">\r
-<h4>\96ß\82è\92l</h4>\r
+<h4>戻り値</h4>\r
 <p>\r
 <a href="rc.html#ok">FR_OK</a>,\r
 <a href="rc.html#de">FR_DISK_ERR</a>,\r
@@ -53,22 +53,58 @@ FRESULT f_stat (
 \r
 \r
 <div class="para desc">\r
-<h4>\89ð\90à</h4>\r
-<p>\8ew\92è\82³\82ê\82½\83t\83@\83C\83\8b\82Ü\82½\82Í\83T\83u\81E\83f\83B\83\8c\83N\83g\83\8a\82Ì\91\8dÝ\82ð\92²\82×\82Ü\82·\81B\91\8dÝ\82µ\82È\82¢\8fê\8d\87\82Í\81A<tt>FR_NO_FILE</tt>\82ª\8bA\82è\82Ü\82·\81B\91\8dÝ\82·\82é\8fê\8d\87\82Í<tt>FR_OK</tt>\82ª\8bA\82è\81A\83t\83@\83C\83\8b\8fî\95ñ\8d\\91¢\91Ì\82É\82»\82ê\8aÖ\82·\82é\8fî\95ñ(\83T\83C\83Y\81A\83^\83C\83\80\83X\83^\83\93\83v\81A\91®\90«\82¨\82æ\82Ñ\92Z\82¢\83t\83@\83C\83\8b\96¼)\82ª\83X\83g\83A\82³\82ê\82Ü\82·\81B</p>\r
+<h4>解説</h4>\r
+<p>指定されたファイルまたはサブ ディレクトリの存在を調べます。存在しない場合は、<tt>FR_NO_FILE</tt>が帰ります。存在する場合は<tt>FR_OK</tt>が帰り、それ関する情報(サイズ、タイムスタンプおよび属性)がファイル情報構造体にストアされます。</p>\r
 </div>\r
 \r
 \r
 <div class="para comp">\r
-<h4>\91Î\89\9e\8fî\95ñ</h4>\r
-<p><tt>_FS_MINIMIZE == 0</tt>\82Ì\82Æ\82«\82É\8eg\97p\89Â\94\\82Å\82·\81B</p>\r
+<h4>対応情報</h4>\r
+<p><tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p>\r
+</div>\r
+\r
+\r
+<div class="para use">\r
+<h4>使用例</h4>\r
+<pre>\r
+    FRESULT fr;\r
+    FILINFO fno;\r
+\r
+\r
+    printf("Test for 'file.txt'...\n");\r
+\r
+    fr = f_stat("file.txt", &amp;fno);\r
+    switch (fr) {\r
+\r
+    case FR_OK:\r
+        printf("Size: %lu\n", fno.fsize);\r
+        printf("Timestamp: %u/%02u/%02u, %02u:%02u\n",\r
+               (fno.fdate &gt;&gt; 9) + 1980, fno.fdate &gt;&gt; 5 &amp; 15, fno.fdate &amp; 31,\r
+               fno.ftime &gt;&gt; 11, fno.ftime &gt;&gt; 5 &amp; 63);\r
+        printf("Attributes: %c%c%c%c%c\n",\r
+               (fno.fattrib &amp; AM_DIR) ? 'D' : '-',\r
+               (fno.fattrib &amp; AM_RDO) ? 'R' : '-',\r
+               (fno.fattrib &amp; AM_HID) ? 'H' : '-',\r
+               (fno.fattrib &amp; AM_SYS) ? 'S' : '-',\r
+               (fno.fattrib &amp; AM_ARC) ? 'A' : '-');\r
+        break;\r
+\r
+    case FR_NO_FILE:\r
+        printf("It is not exist.\n");\r
+        break;\r
+\r
+    default:\r
+        printf("An error occured. (%d)\n", fr);\r
+    }\r
+</pre>\r
 </div>\r
 \r
 \r
 <div class="para ref">\r
-<h4>\8eQ\8fÆ</h4>\r
+<h4>参照</h4>\r
 <p><tt><a href="opendir.html">f_opendir</a>, <a href="readdir.html">f_readdir</a>, <a href="sfileinfo.html">FILINFO</a>, <a href="sdir.html">DIR</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