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

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