fatfs/doc/en/sfileinfo.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html lang="en">
   3 <head>
   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="alternate" hreflang="ja" title="Japanese" href="../ja/sfileinfo.html">
   8 <link rel="stylesheet" href="../css_e.css" type="text/css" media="screen" title="ELM Default">
   9 <title>FatFs - FILINFO</title>
  10 </head>
  11
  12 <body>
  13
  14 <div class="para">
  15 <h2>FILINFO</h2>
  16 <p>The <tt>FILINFO</tt> structure holds a file information returned by <tt>f_readdir()</tt> and <tt>f_stat()</tt> function.</p>
  17 <pre>
  18 <span class="k">typedef struct</span> {
  19     DWORD fsize;      <span class="c">/* File size */</span>
  20     WORD  fdate;      <span class="c">/* Last modified date */</span>
  21     WORD  ftime;      <span class="c">/* Last modified time */</span>
  22     BYTE  fattrib;    <span class="c">/* Attribute */</span>
  23     TCHAR fname[13];  <span class="c">/* Short file name (8.3 format) */</span>
  24 <span class="k">#if</span> _USE_LFN
  25     TCHAR* lfname;    <span class="c">/* Pointer to the LFN buffer */</span>
  26     int   lfsize;     <span class="c">/* Size of the LFN buffer in unit of TCHAR */</span>
  27 <span class="k">#endif</span>
  28 } FILINFO;
  29 </pre>
  30 </div>
  31
  32 <h4>Members</h4>
  33 <dl>
  34 <dt>fsize</dt>
  35 <dd>Indicates size of the file in unit of byte. Always zero for directories.</dd>
  36 <dt>fdate</dt>
  37 <dd>Indicates the date that the file was modified or the directory was created.<br>
  38 <dl>
  39 <dt>bit15:9</dt>
  40 <dd>Year origin from 1980 (0..127)</dd>
  41 <dt>bit8:5</dt>
  42 <dd>Month (1..12)</dd>
  43 <dt>bit4:0</dt>
  44 <dd>Day (1..31)</dd>
  45 </dl>
  46 </dd>
  47 <dt>ftime</dt>
  48 <dd>Indicates the time that the file was modified or the directory was created.<br>
  49 <dl>
  50 <dt>bit15:11</dt>
  51 <dd>Hour (0..23)</dd>
  52 <dt>bit10:5</dt>
  53 <dd>Minute (0..59)</dd>
  54 <dt>bit4:0</dt>
  55 <dd>Second / 2 (0..29)</dd>
  56 </dl>
  57 </dd>
  58 <dt>fattrib</dt>
  59 <dd>Indicates the file/directory attribute in combination of <tt>AM_DIR</tt>, <tt>AM_RDO</tt>, <tt>AM_HID</tt>, <tt>AM_SYS</tt> and <tt>AM_ARC</tt>.</dd>
  60 <dt>fname[]</dt>
  61 <dd>Indicates the file/directory name in 8.3 format null-terminated string. It is always returnd with upper case in non-LFN configuration but it can be returned with lower case in LFN configuration.</dd>
  62 <dt>lfname</dt>
  63 <dd>Pointer to the LFN buffer to store the read LFN. This member must be initialized by application program prior to use this structure. Set a null pointer if LFN is not needed. Not available at non-LFN configuration.</dd>
  64 <dt>lfsize</dt>
  65 <dd>Size of the LFN buffer in unit of TCHAR. This member must be initialized by application program prior to use this structure. Not available at non-LFN configuration.</dd>
  66 </dl>
  67
  68 <p class="foot"><a href="../00index_e.html">Return</a></p>
  69 </body>
  70 </html>