git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/Common/FileSystem/FatFs-0.7e/doc/ja/open.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r
   2 <html lang="ja">\r
   3 <head>\r
   4 <meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">\r
   5 <meta http-equiv="Content-Style-Type" content="text/css">\r
   6 <link rel="up" title="FatFs" href="../00index_j.html">\r
   7 <link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default">\r
   8 <title>FatFs - f_open</title>\r
   9 </head>\r
  10 \r
  11 <body>\r
  12 \r
  13 <div class="para">\r
  14 <h2>f_open</h2>\r
  15 <p>\83t\83@\83C\83\8b\82ð\83I\81[\83v\83\93\82Ü\82½\82Í\8dì\90¬\82µ\82Ü\82·\81B</p>\r
  16 <pre>\r
  17 FRESULT f_open (\r
  18   FIL* <em>FileObject</em>,       /* \8bó\82Ì\83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g\8d\\91¢\91Ì\82Ö\82Ì\83|\83C\83\93\83^ */\r
  19   const XCHAR* <em>FileName</em>, /* \83t\83@\83C\83\8b\82Ì\83t\83\8b\83p\83X\96¼\82Ö\82Ì\83|\83C\83\93\83^ */\r
  20   BYTE <em>ModeFlags</em>         /* \83\82\81[\83h\83t\83\89\83O */\r
  21 );\r
  22 </pre>\r
  23 </div>\r
  24 \r
  25 <div class="para">\r
  26 <h4>\88ø\90\94</h4>\r
  27 <dl class="par">\r
  28 <dt>FileObject</dt>\r
  29 <dd>\90V\82µ\82\8dì\90¬\82·\82é\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\88È\8d~\81A\82»\82Ì\83t\83@\83C\83\8b\82ð\95Â\82¶\82é\82Ü\82Å\82±\82Ì\83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g\82ð\8eg\97p\82µ\82Ä\83t\83@\83C\83\8b\91\80\8dì\82ð\82µ\82Ü\82·\81B</dd>\r
  30 <dt>FileName</dt>\r
  31 <dd>\8aJ\82(\82Ü\82½\82Í\8dì\90¬\82·\82é)\83t\83@\83C\83\8b\82Ì <a href="filename.html">\83t\83@\83C\83\8b\96¼</a>\82ª\93ü\82Á\82½<tt>'\0'</tt>\82Å\8fI\82í\82é\95¶\8e\9a\97ñ\82Ö\82Ì\83|\83C\83\93\83^\82ð\8ew\92è\82µ\82Ü\82·\81B</dd>\r
  32 <dt>ModeFlags</dt>\r
  33 <dd>\83t\83@\83C\83\8b\82Ì\83A\83N\83Z\83X\95û\96@\82â\83I\81[\83v\83\93\95û\96@\82ð\8c\88\82ß\82é\83t\83\89\83O\82Å\82·\81B\82±\82Ì\83p\83\89\83\81\81[\83^\82É\82Í\8e\9f\82Ì\91g\82Ý\8d\87\82í\82¹\82ð\8ew\92è\82µ\82Ü\82·\81B<br>\r
  34 <table class="lst">\r
  35 <tr><th>\92l</th><th>\88Ó\96¡</th></tr>\r
  36 <tr><td>FA_READ</td><td>\93Ç\82Ý\8fo\82µ\83\82\81[\83h\82Å\8aJ\82«\82Ü\82·\81B\93Ç\82Ý\8f\91\82«\82·\82é\8fê\8d\87\82Í<tt>FA_WRITE</tt>\82Æ\8b¤\82É\8ew\92è\82µ\82Ü\82·\81B</td></tr>\r
  37 <tr><td>FA_WRITE</td><td>\8f\91\82«\8d\9e\82Ý\83\82\81[\83h\82Å\8aJ\82«\82Ü\82·\81B\93Ç\82Ý\8f\91\82«\82·\82é\8fê\8d\87\82Í<tt>FA_READ</tt>\82Æ\8b¤\82É\8ew\92è\82µ\82Ü\82·\81B</td></tr>\r
  38 <tr><td>FA_OPEN_EXISTING</td><td>\8aù\91¶\82Ì\83t\83@\83C\83\8b\82ð\8aJ\82«\82Ü\82·\81B\83t\83@\83C\83\8b\82ª\96³\82¢\82Æ\82«\82Í\83G\83\89\81[\82É\82È\82è\82Ü\82·\81B(\83f\83t\83H\83\8b\83g)</td></tr>\r
  39 <tr><td>FA_OPEN_ALWAYS</td><td>\8aù\91¶\82Ì\83t\83@\83C\83\8b\82ð\8aJ\82«\82Ü\82·\81B\83t\83@\83C\83\8b\82ª\96³\82¢\82Æ\82«\82Í\83t\83@\83C\83\8b\82ð\8dì\90¬\82µ\82Ü\82·\81B</td></tr>\r
  40 <tr><td>FA_CREATE_NEW</td><td>\83t\83@\83C\83\8b\82ð\8dì\90¬\82µ\82Ü\82·\81B\93¯\96¼\82Ì\83t\83@\83C\83\8b\82ª\82 \82é\8fê\8d\87\82Í\81A\83G\83\89\81[\82É\82È\82è\82Ü\82·\81B</td></tr>\r
  41 <tr><td>FA_CREATE_ALWAYS</td><td>\83t\83@\83C\83\8b\82ð\8dì\90¬\82µ\82Ü\82·\81B\93¯\96¼\82Ì\83t\83@\83C\83\8b\82ª\82 \82é\8fê\8d\87\82Í\81A\83T\83C\83Y\82ð0\82É\82µ\82Ä\82©\82ç\8aJ\82«\82Ü\82·\81B</td></tr>\r
  42 </table>\r
  43 </dd>\r
  44 </dl>\r
  45 </div>\r
  46 \r
  47 \r
  48 <div class="para">\r
  49 <h4>\96ß\82è\92l</h4>\r
  50 <dl class="ret">\r
  51 <dt>FR_OK (0)</dt>\r
  52 <dd>\90³\8fí\8fI\97¹\81B\88È\8d~\81A<tt>FileObject</tt>\8d\\91¢\91Ì\82ð\8eg\82Á\82Ä\82±\82Ì\83t\83@\83C\83\8b\82ð\91\80\8dì\82Å\82«\82Ü\82·\81B</dd>\r
  53 <dt>FR_NO_FILE</dt>\r
  54 <dd>\83t\83@\83C\83\8b\82ª\8c©\82Â\82©\82ç\82È\82¢\81B</dd>\r
  55 <dt>FR_NO_PATH</dt>\r
  56 <dd>\83p\83X\82ª\8c©\82Â\82©\82ç\82È\82¢\81B</dd>\r
  57 <dt>FR_INVALID_NAME</dt>\r
  58 <dd>\83t\83@\83C\83\8b\96¼\82ª\95s\90³\81B</dd>\r
  59 <dt>FR_INVALID_DRIVE</dt>\r
  60 <dd>\83h\83\89\83C\83u\94Ô\8d\86\82ª\95s\90³\81B</dd>\r
  61 <dt>FR_EXIST</dt>\r
  62 <dd>\93¯\96¼\82Ì\83t\83@\83C\83\8b\82ª\8aù\82É\82 \82é\81B</dd>\r
  63 <dt>FR_DENIED</dt>\r
  64 <dd>\83A\83N\83Z\83X\82ª\8b\91\94Û\82³\82ê\82½\81B\83\8a\81[\83h\81E\83I\83\93\83\8a\81[\81E\83t\83@\83C\83\8b\82Ì\8f\91\82«\8d\9e\82Ý\83\82\81[\83h\81E\83I\81[\83v\83\93\81A\93¯\96¼\82Ì\83f\83B\83\8c\83N\83g\83\8a\82Ü\82½\82Í\83\8a\81[\83h\81E\83I\83\93\83\8a\81[\81E\83t\83@\83C\83\8b\82ª\82 \82é\8fó\91Ô\82Å\82Ì\83t\83@\83C\83\8b\8dì\90¬\81A\83f\83B\83X\83N\82Ü\82½\82Í\83f\83B\83\8c\83N\83g\83\8a\81E\83e\81[\83u\83\8b\82ª\96\9e\94t\82Å\83t\83@\83C\83\8b\82ð\8dì\90¬\82Å\82«\82È\82¢\82È\82Ç\81B</dd>\r
  65 <dt>FR_NOT_READY</dt>\r
  66 <dd>\83\81\83f\83B\83A\82ª\83Z\83b\83g\82³\82ê\82Ä\82¢\82È\82¢\82È\82Ç\81A\95¨\97\9d\83h\83\89\83C\83u\82ª\93®\8dì\95s\94\\8fó\91Ô\81B</dd>\r
  67 <dt>FR_WRITE_PROTECTED</dt>\r
  68 <dd>\83\81\83f\83B\83A\82ª\8f\91\82«\8d\9e\82Ý\8bÖ\8e~\8fó\91Ô\82Å\8f\91\82«\8d\9e\82Ý\8cn\83I\81[\83v\83\93\82ð\82µ\82½\81B</dd>\r
  69 <dt>FR_DISK_ERR</dt>\r
  70 <dd>\83f\83B\83X\83N\81E\83G\83\89\81[\82É\82æ\82é\8e¸\94s\81B</dd>\r
  71 <dt>FR_INT_ERR</dt>\r
  72 <dd>\95s\90³\82ÈFAT\8d\\91¢\82Ü\82½\82Í\93à\95\94\83G\83\89\81[\82É\82æ\82é\8e¸\94s\81B</dd>\r
  73 <dt>FR_NOT_ENABLED</dt>\r
  74 <dd>\82»\82Ì\98_\97\9d\83h\83\89\83C\83u\82É\83\8f\81[\83N\81E\83G\83\8a\83A\82ª\8a\84\82è\93\96\82Ä\82ç\82ê\82Ä\82¢\82È\82¢\81B</dd>\r
  75 <dt>FR_NO_FILESYSTEM</dt>\r
  76 <dd>\83f\83B\83X\83N\8fã\82É\97L\8cø\82ÈFAT\83{\83\8a\83\85\81[\83\80\82ª\8c©\82Â\82©\82ç\82È\82¢\81B</dd>\r
  77 </dl>\r
  78 </div>\r
  79 \r
  80 \r
  81 <div class="para">\r
  82 <h4>\89ð\90à</h4>\r
  83 <p>\8aù\91¶\82Ì\83t\83@\83C\83\8b\82ð\8aJ\82¢\82½\82è\81A\90V\82µ\82¢\83t\83@\83C\83\8b\82ð\8dì\90¬\82µ\82Ü\82·\81B\8aÖ\90\94\82ª\90¬\8c÷\82·\82é\82Æ\83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g\82ª\8dì\90¬\82³\82ê\81A\88È\8d~\82»\82Ì\83t\83@\83C\83\8b\82É\91Î\82·\82é\83A\83N\83Z\83X\82É\8eg\97p\82µ\82Ü\82·\81B\83t\83@\83C\83\8b\82ð\95Â\82¶\82é\82Æ\82«\82Í\81A<a href="close.html">f_close()</a>\82ð\8eg\97p\82µ\82Ü\82·\81B\89½\82ç\82©\82Ì\95Ï\8dX\82ª\8ds\82í\82ê\82½\83t\83@\83C\83\8b\82ª\82»\82Ì\8cã\90³\82µ\82\95Â\82¶\82ç\82ê\82È\82©\82Á\82½\8fê\8d\87\81A\82»\82Ì\83t\83@\83C\83\8b\82ª\94j\91¹\82·\82é\8fê\8d\87\82ª\82 \82è\82Ü\82·\81B</p>\r
  84 <p>\83t\83@\83C\83\8b\81E\83A\83N\83Z\83X\82ð\8aJ\8en\82·\82é\91O\82É\81A<a href="mount.html">f_mount()</a>\82ð\8eg\82Á\82Ä\82»\82ê\82¼\82ê\82Ì\98_\97\9d\83h\83\89\83C\83u\82É\83\8f\81[\83N\81E\83G\83\8a\83A(\83t\83@\83C\83\8b\81E\83V\83X\83e\83\80\81E\83I\83u\83W\83F\83N\83g)\82ð\97^\82¦\82é\95K\97v\82ª\82 \82è\82Ü\82·\81B\82±\82Ì\8f\89\8aú\89»\82Ì\8cã\81A\82»\82Ì\98_\97\9d\83h\83\89\83C\83u\82É\91Î\82µ\82Ä\91S\82Ä\82Ì\83t\83@\83C\83\8b\8aÖ\90\94\82ª\8eg\82¦\82é\82æ\82¤\82É\82È\82è\82Ü\82·\81B</p>\r
  85 </div>\r
  86 \r
  87 \r
  88 <div class="para">\r
  89 <h4>\91Î\89\9e\8fî\95ñ</h4>\r
  90 <p>\91S\82Ä\82Ì\8d\\90¬\82Å\8eg\97p\89Â\94\\82Å\82·\81B<tt>_FS_READONLY == 1</tt>\82Ì\82Æ\82«\82Í\81A<tt>FA_WRITE, FA_CREATE_ALWAYS, FA_CREATE_NEW, FA_OPEN_ALWAYS</tt>\82Ì\8ae\83t\83\89\83O\82Í\83T\83|\81[\83g\82³\82ê\82Ü\82¹\82ñ\81B</p>\r
  91 </div>\r
  92 \r
  93 \r
  94 <div class="para">\r
  95 <h4>\8eg\97p\97á\81i\83t\83@\83C\83\8b\81E\83R\83s\81[\81j</h4>\r
  96 <pre>\r
  97 void main (void)\r
  98 {\r
  99     FATFS fs[2];         /* \98_\97\9d\83h\83\89\83C\83u\82Ì\83\8f\81[\83N\81E\83G\83\8a\83A(\83t\83@\83C\83\8b\81E\83V\83X\83e\83\80\81E\83I\83u\83W\83F\83N\83g) */\r
 100     FIL fsrc, fdst;      /* \83t\83@\83C\83\8b\81E\83I\83u\83W\83F\83N\83g */\r
 101     BYTE buffer[4096];   /* file copy buffer */\r
 102     FRESULT res;         /* FatFs function common result code */\r
 103     UINT br, bw;         /* File R/W count */\r
 104 \r
 105     /* \83h\83\89\83C\83u0,1\82É\83\8f\81[\83N\81E\83G\83\8a\83A\82ð\97^\82¦\82é */\r
 106     f_mount(0, &amp;fs[0]);\r
 107     f_mount(1, &amp;fs[1]);\r
 108 \r
 109     /* \83h\83\89\83C\83u1\82Ì\83\\81[\83X\81E\83t\83@\83C\83\8b\82ð\8aJ\82 */\r
 110     res = f_open(&amp;fsrc, "1:srcfile.dat", FA_OPEN_EXISTING | FA_READ);\r
 111     if (res) die(res);\r
 112 \r
 113     /* \83h\83\89\83C\83u0\82É\83f\83X\83e\83B\83l\81[\83V\83\87\83\93\81E\83t\83@\83C\83\8b\82ð\8dì\90¬\82·\82é */\r
 114     res = f_open(&amp;fdst, "0:dstfile.dat", FA_CREATE_ALWAYS | FA_WRITE);\r
 115     if (res) die(res);\r
 116 \r
 117     /* \83\\81[\83X\82©\82ç\83f\83X\83e\83B\83l\81[\83V\83\87\83\93\82É\83R\83s\81[\82·\82é */\r
 118     for (;;) {\r
 119         res = f_read(&amp;fsrc, buffer, sizeof(buffer), &amp;br);\r
 120         if (res || br == 0) break;   /* \83G\83\89\81[\82©\83t\83@\83C\83\8b\8fI\92[ */\r
 121         res = f_write(&amp;fdst, buffer, br, &amp;bw);\r
 122         if (res || bw &lt; br) break;   /* \83G\83\89\81[\82©\83f\83B\83X\83N\96\9e\94t */\r
 123     }\r
 124 \r
 125     /* \91S\82Ä\82Ì\83t\83@\83C\83\8b\82ð\95Â\82¶\82é */\r
 126     f_close(&amp;fsrc);\r
 127     f_close(&amp;fdst);\r
 128 \r
 129     /* \83\8f\81[\83N\81E\83G\83\8a\83A\82ð\8aJ\95ú\82·\82é */\r
 130     f_mount(0, NULL);\r
 131     f_mount(1, NULL);\r
 132 }\r
 133 </pre>\r
 134 </div>\r
 135 \r
 136 \r
 137 <div class="para">\r
 138 <h4>\8eQ\8fÆ</h4>\r
 139 <p><tt><a href="read.html">f_read</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a>, <a href="sfatfs.html">FATFS</a></tt></p>\r
 140 </div>\r
 141 \r
 142 <p class="foot"><a href="../00index_j.html">\96ß\82é</a></p>\r
 143 </body>\r
 144 </html>\r