You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1340 lines
58KB

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=9"/>
  6. <meta name="generator" content="Doxygen 1.8.10"/>
  7. <title>SdFat: FatFileSystem Class Reference</title>
  8. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  9. <script type="text/javascript" src="jquery.js"></script>
  10. <script type="text/javascript" src="dynsections.js"></script>
  11. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  12. <script type="text/javascript" src="search/searchdata.js"></script>
  13. <script type="text/javascript" src="search/search.js"></script>
  14. <script type="text/javascript">
  15. $(document).ready(function() { init_search(); });
  16. </script>
  17. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  18. </head>
  19. <body>
  20. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  21. <div id="titlearea">
  22. <table cellspacing="0" cellpadding="0">
  23. <tbody>
  24. <tr style="height: 56px;">
  25. <td id="projectalign" style="padding-left: 0.5em;">
  26. <div id="projectname">SdFat
  27. </div>
  28. </td>
  29. </tr>
  30. </tbody>
  31. </table>
  32. </div>
  33. <!-- end header part -->
  34. <!-- Generated by Doxygen 1.8.10 -->
  35. <script type="text/javascript">
  36. var searchBox = new SearchBox("searchBox", "search",false,'Search');
  37. </script>
  38. <div id="navrow1" class="tabs">
  39. <ul class="tablist">
  40. <li><a href="index.html"><span>Main&#160;Page</span></a></li>
  41. <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
  42. <li><a href="files.html"><span>Files</span></a></li>
  43. <li>
  44. <div id="MSearchBox" class="MSearchBoxInactive">
  45. <span class="left">
  46. <img id="MSearchSelect" src="search/mag_sel.png"
  47. onmouseover="return searchBox.OnSearchSelectShow()"
  48. onmouseout="return searchBox.OnSearchSelectHide()"
  49. alt=""/>
  50. <input type="text" id="MSearchField" value="Search" accesskey="S"
  51. onfocus="searchBox.OnSearchFieldFocus(true)"
  52. onblur="searchBox.OnSearchFieldFocus(false)"
  53. onkeyup="searchBox.OnSearchFieldChange(event)"/>
  54. </span><span class="right">
  55. <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
  56. </span>
  57. </div>
  58. </li>
  59. </ul>
  60. </div>
  61. <div id="navrow2" class="tabs2">
  62. <ul class="tablist">
  63. <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
  64. <li><a href="inherits.html"><span>Class&#160;Hierarchy</span></a></li>
  65. <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
  66. </ul>
  67. </div>
  68. <!-- window showing the filter options -->
  69. <div id="MSearchSelectWindow"
  70. onmouseover="return searchBox.OnSearchSelectShow()"
  71. onmouseout="return searchBox.OnSearchSelectHide()"
  72. onkeydown="return searchBox.OnSearchSelectKey(event)">
  73. </div>
  74. <!-- iframe showing the search results (closed by default) -->
  75. <div id="MSearchResultsWindow">
  76. <iframe src="javascript:void(0)" frameborder="0"
  77. name="MSearchResults" id="MSearchResults">
  78. </iframe>
  79. </div>
  80. </div><!-- top -->
  81. <div class="header">
  82. <div class="summary">
  83. <a href="#pub-methods">Public Member Functions</a> &#124;
  84. <a href="class_fat_file_system-members.html">List of all members</a> </div>
  85. <div class="headertitle">
  86. <div class="title">FatFileSystem Class Reference</div> </div>
  87. </div><!--header-->
  88. <div class="contents">
  89. <p>Integration class for the FatLib library.
  90. <a href="class_fat_file_system.html#details">More...</a></p>
  91. <p><code>#include &lt;FatFileSystem.h&gt;</code></p>
  92. <div class="dynheader">
  93. Inheritance diagram for FatFileSystem:</div>
  94. <div class="dyncontent">
  95. <div class="center"><img src="class_fat_file_system__inherit__graph.png" border="0" usemap="#_fat_file_system_inherit__map" alt="Inheritance graph"/></div>
  96. <map name="_fat_file_system_inherit__map" id="_fat_file_system_inherit__map">
  97. <area shape="rect" id="node3" href="class_sd_file_system.html" title="Virtual base class for SdFat library. " alt="" coords="293,5,503,32"/>
  98. <area shape="rect" id="node4" href="class_sd_file_system.html" title="SdFileSystem\&lt; SdioCard \&gt;" alt="" coords="307,56,489,83"/>
  99. <area shape="rect" id="node6" href="class_sd_file_system.html" title="SdFileSystem\&lt; SdSpiCard \&gt;" alt="" coords="303,107,493,133"/>
  100. <area shape="rect" id="node9" href="class_sd_file_system.html" title="SdFileSystem\&lt; SdSpiCardEX \&gt;" alt="" coords="295,195,501,221"/>
  101. <area shape="rect" id="node2" href="class_fat_volume.html" title="Access FAT16 and FAT32 volumes on raw file devices. " alt="" coords="5,81,91,108"/>
  102. <area shape="rect" id="node5" href="class_sd_fat_sdio.html" title="SdFat class using SDIO. " alt="" coords="599,27,681,53"/>
  103. <area shape="rect" id="node7" href="class_sd_fat.html" title="Main file system class for SdFat library. " alt="" coords="611,77,669,104"/>
  104. <area shape="rect" id="node8" href="class_sd_fat_soft_spi.html" title="SdFat class using software SPI. " alt="" coords="559,129,721,170"/>
  105. <area shape="rect" id="node10" href="class_sd_fat_e_x.html" title="SdFat class with extended SD I/O. " alt="" coords="603,195,677,221"/>
  106. <area shape="rect" id="node11" href="class_sd_fat_soft_spi_e_x.html" title="SdFat class using software SPI and extended SD I/O. " alt="" coords="551,246,729,287"/>
  107. </map>
  108. <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
  109. <div class="dynheader">
  110. Collaboration diagram for FatFileSystem:</div>
  111. <div class="dyncontent">
  112. <div class="center"><img src="class_fat_file_system__coll__graph.png" border="0" usemap="#_fat_file_system_coll__map" alt="Collaboration graph"/></div>
  113. <map name="_fat_file_system_coll__map" id="_fat_file_system_coll__map">
  114. <area shape="rect" id="node2" href="class_fat_volume.html" title="Access FAT16 and FAT32 volumes on raw file devices. " alt="" coords="16,5,101,32"/>
  115. </map>
  116. <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
  117. <table class="memberdecls">
  118. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  119. Public Member Functions</h2></td></tr>
  120. <tr class="memitem:a5dda20d3dcbfc8c641babbb2c9aac382"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a5dda20d3dcbfc8c641babbb2c9aac382">begin</a> (<a class="el" href="_block_driver_8h.html#ace97f2377acdc471a01f9f7ec1fd6bbb">BlockDriver</a> *blockDev, uint8_t part=0)</td></tr>
  121. <tr class="separator:a5dda20d3dcbfc8c641babbb2c9aac382"><td class="memSeparator" colspan="2">&#160;</td></tr>
  122. <tr class="memitem:a06beed4cea5e38116b58254a57125442"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a06beed4cea5e38116b58254a57125442">blocksPerCluster</a> () const </td></tr>
  123. <tr class="separator:a06beed4cea5e38116b58254a57125442"><td class="memSeparator" colspan="2">&#160;</td></tr>
  124. <tr class="memitem:abc66d856d05198d9ebe7104c8c4155d7"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#abc66d856d05198d9ebe7104c8c4155d7">blocksPerFat</a> () const </td></tr>
  125. <tr class="separator:abc66d856d05198d9ebe7104c8c4155d7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  126. <tr class="memitem:aa1e3b1d0c21d202deb82668068ab00e8"><td class="memItemLeft" align="right" valign="top"><a class="el" href="unioncache__t.html">cache_t</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#aa1e3b1d0c21d202deb82668068ab00e8">cacheClear</a> ()</td></tr>
  127. <tr class="separator:aa1e3b1d0c21d202deb82668068ab00e8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  128. <tr class="memitem:a5667915e63187a43a71dfada63800865"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a5667915e63187a43a71dfada63800865">chdir</a> (bool set_cwd=false)</td></tr>
  129. <tr class="separator:a5667915e63187a43a71dfada63800865"><td class="memSeparator" colspan="2">&#160;</td></tr>
  130. <tr class="memitem:a44af1b98e8d986d12107b654453acbc4"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a44af1b98e8d986d12107b654453acbc4">chdir</a> (const char *path, bool set_cwd=false)</td></tr>
  131. <tr class="separator:a44af1b98e8d986d12107b654453acbc4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  132. <tr class="memitem:af24917d6e00c8766dab168eb834047ec"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#af24917d6e00c8766dab168eb834047ec">chvol</a> ()</td></tr>
  133. <tr class="separator:af24917d6e00c8766dab168eb834047ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
  134. <tr class="memitem:a18446a9c5924304fa7a87d5f03ccaf21"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a18446a9c5924304fa7a87d5f03ccaf21">clusterCount</a> () const </td></tr>
  135. <tr class="separator:a18446a9c5924304fa7a87d5f03ccaf21"><td class="memSeparator" colspan="2">&#160;</td></tr>
  136. <tr class="memitem:ac0e63f33d71d5dc95a602834274def6a"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#ac0e63f33d71d5dc95a602834274def6a">clusterSizeShift</a> () const </td></tr>
  137. <tr class="separator:ac0e63f33d71d5dc95a602834274def6a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  138. <tr class="memitem:a443364af257c219f8e908d5b073d8fa3"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a443364af257c219f8e908d5b073d8fa3">dataStartBlock</a> () const </td></tr>
  139. <tr class="separator:a443364af257c219f8e908d5b073d8fa3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  140. <tr class="memitem:a25c6311b70fa274b3be94ff25fdebba7"><td class="memItemLeft" align="right" valign="top">int8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a25c6311b70fa274b3be94ff25fdebba7">dbgFat</a> (uint32_t n, uint32_t *v)</td></tr>
  141. <tr class="separator:a25c6311b70fa274b3be94ff25fdebba7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  142. <tr class="memitem:aee58c6352652f216577196e32a594b67"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#aee58c6352652f216577196e32a594b67">exists</a> (const char *path)</td></tr>
  143. <tr class="separator:aee58c6352652f216577196e32a594b67"><td class="memSeparator" colspan="2">&#160;</td></tr>
  144. <tr class="memitem:acdedc6a200b01e401c9cd9b511eae6ec"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#acdedc6a200b01e401c9cd9b511eae6ec">fatCount</a> ()</td></tr>
  145. <tr class="separator:acdedc6a200b01e401c9cd9b511eae6ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
  146. <tr class="memitem:a0dd0cc689b63ef0702aed1cf36b1722d"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a0dd0cc689b63ef0702aed1cf36b1722d">fatStartBlock</a> () const </td></tr>
  147. <tr class="separator:a0dd0cc689b63ef0702aed1cf36b1722d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  148. <tr class="memitem:a1364f11fe9bb4717ce0685e2b7b86027"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a1364f11fe9bb4717ce0685e2b7b86027">fatType</a> () const </td></tr>
  149. <tr class="separator:a1364f11fe9bb4717ce0685e2b7b86027"><td class="memSeparator" colspan="2">&#160;</td></tr>
  150. <tr class="memitem:a1683b063fc6202ab85470b9610f16f93"><td class="memItemLeft" align="right" valign="top">int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a1683b063fc6202ab85470b9610f16f93">freeClusterCount</a> ()</td></tr>
  151. <tr class="separator:a1683b063fc6202ab85470b9610f16f93"><td class="memSeparator" colspan="2">&#160;</td></tr>
  152. <tr class="memitem:acab819fa25a91dad1cc698a7e1e0eb32"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#acab819fa25a91dad1cc698a7e1e0eb32">init</a> ()</td></tr>
  153. <tr class="separator:acab819fa25a91dad1cc698a7e1e0eb32"><td class="memSeparator" colspan="2">&#160;</td></tr>
  154. <tr class="memitem:a034d997a1e7a0b2b664a4357bcccd256"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a034d997a1e7a0b2b664a4357bcccd256">init</a> (uint8_t part)</td></tr>
  155. <tr class="separator:a034d997a1e7a0b2b664a4357bcccd256"><td class="memSeparator" colspan="2">&#160;</td></tr>
  156. <tr class="memitem:a2398fb37a7a9d5e0dc0ffde6a44a993d"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a2398fb37a7a9d5e0dc0ffde6a44a993d">ls</a> (uint8_t flags=0)</td></tr>
  157. <tr class="separator:a2398fb37a7a9d5e0dc0ffde6a44a993d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  158. <tr class="memitem:a122b61dbec5051304bcc81bc08b1b99d"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a122b61dbec5051304bcc81bc08b1b99d">ls</a> (const char *path, uint8_t flags=0)</td></tr>
  159. <tr class="separator:a122b61dbec5051304bcc81bc08b1b99d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  160. <tr class="memitem:ae12fb8bfad5c4a8e052dda70a5a0ed93"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#ae12fb8bfad5c4a8e052dda70a5a0ed93">ls</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr, uint8_t flags=0)</td></tr>
  161. <tr class="separator:ae12fb8bfad5c4a8e052dda70a5a0ed93"><td class="memSeparator" colspan="2">&#160;</td></tr>
  162. <tr class="memitem:aa79695db8e910300507210b3067d39fd"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#aa79695db8e910300507210b3067d39fd">ls</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr, const char *path, uint8_t flags)</td></tr>
  163. <tr class="separator:aa79695db8e910300507210b3067d39fd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  164. <tr class="memitem:a231c62c98ba8ac3c2624dc5ad2053ebf"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a231c62c98ba8ac3c2624dc5ad2053ebf">mkdir</a> (const char *path, bool pFlag=true)</td></tr>
  165. <tr class="separator:a231c62c98ba8ac3c2624dc5ad2053ebf"><td class="memSeparator" colspan="2">&#160;</td></tr>
  166. <tr class="memitem:a947e4586077a922892b632edac33b67a"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html">File</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a947e4586077a922892b632edac33b67a">open</a> (const char *path, uint8_t mode=<a class="el" href="_arduino_files_8h.html#ad52d51659a75e25d96fb04d22ff718cb">FILE_READ</a>)</td></tr>
  167. <tr class="separator:a947e4586077a922892b632edac33b67a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  168. <tr class="memitem:a0abfb1f754a8fb559cfa884ee040f56f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html">File</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a0abfb1f754a8fb559cfa884ee040f56f">open</a> (const String &amp;path, uint8_t mode=<a class="el" href="_arduino_files_8h.html#ad52d51659a75e25d96fb04d22ff718cb">FILE_READ</a>)</td></tr>
  169. <tr class="separator:a0abfb1f754a8fb559cfa884ee040f56f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  170. <tr class="memitem:abf7d7d0dab43083d5be10d70ff4669e4"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#abf7d7d0dab43083d5be10d70ff4669e4">remove</a> (const char *path)</td></tr>
  171. <tr class="separator:abf7d7d0dab43083d5be10d70ff4669e4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  172. <tr class="memitem:a0187891a24017b41bd7c5ba63e659e65"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a0187891a24017b41bd7c5ba63e659e65">rename</a> (const char *oldPath, const char *newPath)</td></tr>
  173. <tr class="separator:a0187891a24017b41bd7c5ba63e659e65"><td class="memSeparator" colspan="2">&#160;</td></tr>
  174. <tr class="memitem:aaed2edc7ff7fedb163458c870bb41b33"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#aaed2edc7ff7fedb163458c870bb41b33">rmdir</a> (const char *path)</td></tr>
  175. <tr class="separator:aaed2edc7ff7fedb163458c870bb41b33"><td class="memSeparator" colspan="2">&#160;</td></tr>
  176. <tr class="memitem:ab2d483670a0a6a6a4754b23614fe11bc"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#ab2d483670a0a6a6a4754b23614fe11bc">rootDirEntryCount</a> () const </td></tr>
  177. <tr class="separator:ab2d483670a0a6a6a4754b23614fe11bc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  178. <tr class="memitem:ae9363ebbbae90e895ea56e8fa3f60c13"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#ae9363ebbbae90e895ea56e8fa3f60c13">rootDirStart</a> () const </td></tr>
  179. <tr class="separator:ae9363ebbbae90e895ea56e8fa3f60c13"><td class="memSeparator" colspan="2">&#160;</td></tr>
  180. <tr class="memitem:ad60cb13557f35578f868e03e9ccb8be1"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#ad60cb13557f35578f868e03e9ccb8be1">truncate</a> (const char *path, uint32_t length)</td></tr>
  181. <tr class="separator:ad60cb13557f35578f868e03e9ccb8be1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  182. <tr class="memitem:a4ca68fe47bb675df0a80df1ed7a53698"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_fat_volume.html">FatVolume</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a4ca68fe47bb675df0a80df1ed7a53698">vol</a> ()</td></tr>
  183. <tr class="separator:a4ca68fe47bb675df0a80df1ed7a53698"><td class="memSeparator" colspan="2">&#160;</td></tr>
  184. <tr class="memitem:a07bc98088ce4a9c725700899c184f7fc"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_volume.html#a07bc98088ce4a9c725700899c184f7fc">volumeBlockCount</a> () const </td></tr>
  185. <tr class="separator:a07bc98088ce4a9c725700899c184f7fc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  186. <tr class="memitem:acf257d02b7166683bda2abc5058004bf"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#acf257d02b7166683bda2abc5058004bf">vwd</a> ()</td></tr>
  187. <tr class="separator:acf257d02b7166683bda2abc5058004bf"><td class="memSeparator" colspan="2">&#160;</td></tr>
  188. <tr class="memitem:a36d7831f92acfbfef1c4a24dd7103dc4"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file_system.html#a36d7831f92acfbfef1c4a24dd7103dc4">wipe</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr=0)</td></tr>
  189. <tr class="separator:a36d7831f92acfbfef1c4a24dd7103dc4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  190. </table>
  191. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  192. <div class="textblock"><p>Integration class for the FatLib library. </p>
  193. </div><h2 class="groupheader">Member Function Documentation</h2>
  194. <a class="anchor" id="a5dda20d3dcbfc8c641babbb2c9aac382"></a>
  195. <div class="memitem">
  196. <div class="memproto">
  197. <table class="mlabels">
  198. <tr>
  199. <td class="mlabels-left">
  200. <table class="memname">
  201. <tr>
  202. <td class="memname">bool FatFileSystem::begin </td>
  203. <td>(</td>
  204. <td class="paramtype"><a class="el" href="_block_driver_8h.html#ace97f2377acdc471a01f9f7ec1fd6bbb">BlockDriver</a> *&#160;</td>
  205. <td class="paramname"><em>blockDev</em>, </td>
  206. </tr>
  207. <tr>
  208. <td class="paramkey"></td>
  209. <td></td>
  210. <td class="paramtype">uint8_t&#160;</td>
  211. <td class="paramname"><em>part</em> = <code>0</code>&#160;</td>
  212. </tr>
  213. <tr>
  214. <td></td>
  215. <td>)</td>
  216. <td></td><td></td>
  217. </tr>
  218. </table>
  219. </td>
  220. <td class="mlabels-right">
  221. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  222. </tr>
  223. </table>
  224. </div><div class="memdoc">
  225. <p>Initialize an <a class="el" href="class_fat_file_system.html" title="Integration class for the FatLib library. ">FatFileSystem</a> object. </p><dl class="params"><dt>Parameters</dt><dd>
  226. <table class="params">
  227. <tr><td class="paramdir">[in]</td><td class="paramname">blockDev</td><td>Device block driver. </td></tr>
  228. <tr><td class="paramdir">[in]</td><td class="paramname">part</td><td>partition to initialize. </td></tr>
  229. </table>
  230. </dd>
  231. </dl>
  232. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  233. </div>
  234. </div>
  235. <a class="anchor" id="a06beed4cea5e38116b58254a57125442"></a>
  236. <div class="memitem">
  237. <div class="memproto">
  238. <table class="mlabels">
  239. <tr>
  240. <td class="mlabels-left">
  241. <table class="memname">
  242. <tr>
  243. <td class="memname">uint8_t FatVolume::blocksPerCluster </td>
  244. <td>(</td>
  245. <td class="paramname"></td><td>)</td>
  246. <td> const</td>
  247. </tr>
  248. </table>
  249. </td>
  250. <td class="mlabels-right">
  251. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  252. </tr>
  253. </table>
  254. </div><div class="memdoc">
  255. <dl class="section return"><dt>Returns</dt><dd>The volume's cluster size in blocks. </dd></dl>
  256. </div>
  257. </div>
  258. <a class="anchor" id="abc66d856d05198d9ebe7104c8c4155d7"></a>
  259. <div class="memitem">
  260. <div class="memproto">
  261. <table class="mlabels">
  262. <tr>
  263. <td class="mlabels-left">
  264. <table class="memname">
  265. <tr>
  266. <td class="memname">uint32_t FatVolume::blocksPerFat </td>
  267. <td>(</td>
  268. <td class="paramname"></td><td>)</td>
  269. <td> const</td>
  270. </tr>
  271. </table>
  272. </td>
  273. <td class="mlabels-right">
  274. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  275. </tr>
  276. </table>
  277. </div><div class="memdoc">
  278. <dl class="section return"><dt>Returns</dt><dd>The number of blocks in one FAT. </dd></dl>
  279. </div>
  280. </div>
  281. <a class="anchor" id="aa1e3b1d0c21d202deb82668068ab00e8"></a>
  282. <div class="memitem">
  283. <div class="memproto">
  284. <table class="mlabels">
  285. <tr>
  286. <td class="mlabels-left">
  287. <table class="memname">
  288. <tr>
  289. <td class="memname"><a class="el" href="unioncache__t.html">cache_t</a>* FatVolume::cacheClear </td>
  290. <td>(</td>
  291. <td class="paramname"></td><td>)</td>
  292. <td></td>
  293. </tr>
  294. </table>
  295. </td>
  296. <td class="mlabels-right">
  297. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  298. </tr>
  299. </table>
  300. </div><div class="memdoc">
  301. <p>Clear the cache and returns a pointer to the cache. Not for normal apps. </p><dl class="section return"><dt>Returns</dt><dd>A pointer to the cache buffer or zero if an error occurs. </dd></dl>
  302. </div>
  303. </div>
  304. <a class="anchor" id="a5667915e63187a43a71dfada63800865"></a>
  305. <div class="memitem">
  306. <div class="memproto">
  307. <table class="mlabels">
  308. <tr>
  309. <td class="mlabels-left">
  310. <table class="memname">
  311. <tr>
  312. <td class="memname">bool FatFileSystem::chdir </td>
  313. <td>(</td>
  314. <td class="paramtype">bool&#160;</td>
  315. <td class="paramname"><em>set_cwd</em> = <code>false</code></td><td>)</td>
  316. <td></td>
  317. </tr>
  318. </table>
  319. </td>
  320. <td class="mlabels-right">
  321. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  322. </tr>
  323. </table>
  324. </div><div class="memdoc">
  325. <p>Change a volume's working directory to root</p>
  326. <p>Changes the volume's working directory to the SD's root directory. Optionally set the current working directory to the volume's working directory.</p>
  327. <dl class="params"><dt>Parameters</dt><dd>
  328. <table class="params">
  329. <tr><td class="paramdir">[in]</td><td class="paramname">set_cwd</td><td>Set the current working directory to this volume's working directory if true.</td></tr>
  330. </table>
  331. </dd>
  332. </dl>
  333. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  334. </div>
  335. </div>
  336. <a class="anchor" id="a44af1b98e8d986d12107b654453acbc4"></a>
  337. <div class="memitem">
  338. <div class="memproto">
  339. <table class="mlabels">
  340. <tr>
  341. <td class="mlabels-left">
  342. <table class="memname">
  343. <tr>
  344. <td class="memname">bool FatFileSystem::chdir </td>
  345. <td>(</td>
  346. <td class="paramtype">const char *&#160;</td>
  347. <td class="paramname"><em>path</em>, </td>
  348. </tr>
  349. <tr>
  350. <td class="paramkey"></td>
  351. <td></td>
  352. <td class="paramtype">bool&#160;</td>
  353. <td class="paramname"><em>set_cwd</em> = <code>false</code>&#160;</td>
  354. </tr>
  355. <tr>
  356. <td></td>
  357. <td>)</td>
  358. <td></td><td></td>
  359. </tr>
  360. </table>
  361. </td>
  362. <td class="mlabels-right">
  363. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  364. </tr>
  365. </table>
  366. </div><div class="memdoc">
  367. <p>Change a volume's working directory</p>
  368. <p>Changes the volume working directory to the <em>path</em> subdirectory. Optionally set the current working directory to the volume's working directory.</p>
  369. <p>Example: If the volume's working directory is "/DIR", chdir("SUB") will change the volume's working directory from "/DIR" to "/DIR/SUB".</p>
  370. <p>If path is "/", the volume's working directory will be changed to the root directory</p>
  371. <dl class="params"><dt>Parameters</dt><dd>
  372. <table class="params">
  373. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>The name of the subdirectory.</td></tr>
  374. <tr><td class="paramdir">[in]</td><td class="paramname">set_cwd</td><td>Set the current working directory to this volume's working directory if true.</td></tr>
  375. </table>
  376. </dd>
  377. </dl>
  378. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  379. </div>
  380. </div>
  381. <a class="anchor" id="af24917d6e00c8766dab168eb834047ec"></a>
  382. <div class="memitem">
  383. <div class="memproto">
  384. <table class="mlabels">
  385. <tr>
  386. <td class="mlabels-left">
  387. <table class="memname">
  388. <tr>
  389. <td class="memname">void FatFileSystem::chvol </td>
  390. <td>(</td>
  391. <td class="paramname"></td><td>)</td>
  392. <td></td>
  393. </tr>
  394. </table>
  395. </td>
  396. <td class="mlabels-right">
  397. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  398. </tr>
  399. </table>
  400. </div><div class="memdoc">
  401. <p>Set the current working directory to a volume's working directory.</p>
  402. <p>This is useful with multiple SD cards.</p>
  403. <p>The current working directory is changed to this volume's working directory.</p>
  404. <p>This is like the Windows/DOS &lt;drive letter&gt;: command. </p>
  405. </div>
  406. </div>
  407. <a class="anchor" id="a18446a9c5924304fa7a87d5f03ccaf21"></a>
  408. <div class="memitem">
  409. <div class="memproto">
  410. <table class="mlabels">
  411. <tr>
  412. <td class="mlabels-left">
  413. <table class="memname">
  414. <tr>
  415. <td class="memname">uint32_t FatVolume::clusterCount </td>
  416. <td>(</td>
  417. <td class="paramname"></td><td>)</td>
  418. <td> const</td>
  419. </tr>
  420. </table>
  421. </td>
  422. <td class="mlabels-right">
  423. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  424. </tr>
  425. </table>
  426. </div><div class="memdoc">
  427. <dl class="section return"><dt>Returns</dt><dd>The total number of clusters in the volume. </dd></dl>
  428. </div>
  429. </div>
  430. <a class="anchor" id="ac0e63f33d71d5dc95a602834274def6a"></a>
  431. <div class="memitem">
  432. <div class="memproto">
  433. <table class="mlabels">
  434. <tr>
  435. <td class="mlabels-left">
  436. <table class="memname">
  437. <tr>
  438. <td class="memname">uint8_t FatVolume::clusterSizeShift </td>
  439. <td>(</td>
  440. <td class="paramname"></td><td>)</td>
  441. <td> const</td>
  442. </tr>
  443. </table>
  444. </td>
  445. <td class="mlabels-right">
  446. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  447. </tr>
  448. </table>
  449. </div><div class="memdoc">
  450. <dl class="section return"><dt>Returns</dt><dd>The shift count required to multiply by blocksPerCluster. </dd></dl>
  451. </div>
  452. </div>
  453. <a class="anchor" id="a443364af257c219f8e908d5b073d8fa3"></a>
  454. <div class="memitem">
  455. <div class="memproto">
  456. <table class="mlabels">
  457. <tr>
  458. <td class="mlabels-left">
  459. <table class="memname">
  460. <tr>
  461. <td class="memname">uint32_t FatVolume::dataStartBlock </td>
  462. <td>(</td>
  463. <td class="paramname"></td><td>)</td>
  464. <td> const</td>
  465. </tr>
  466. </table>
  467. </td>
  468. <td class="mlabels-right">
  469. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  470. </tr>
  471. </table>
  472. </div><div class="memdoc">
  473. <dl class="section return"><dt>Returns</dt><dd>The logical block number for the start of file data. </dd></dl>
  474. </div>
  475. </div>
  476. <a class="anchor" id="a25c6311b70fa274b3be94ff25fdebba7"></a>
  477. <div class="memitem">
  478. <div class="memproto">
  479. <table class="mlabels">
  480. <tr>
  481. <td class="mlabels-left">
  482. <table class="memname">
  483. <tr>
  484. <td class="memname">int8_t FatVolume::dbgFat </td>
  485. <td>(</td>
  486. <td class="paramtype">uint32_t&#160;</td>
  487. <td class="paramname"><em>n</em>, </td>
  488. </tr>
  489. <tr>
  490. <td class="paramkey"></td>
  491. <td></td>
  492. <td class="paramtype">uint32_t *&#160;</td>
  493. <td class="paramname"><em>v</em>&#160;</td>
  494. </tr>
  495. <tr>
  496. <td></td>
  497. <td>)</td>
  498. <td></td><td></td>
  499. </tr>
  500. </table>
  501. </td>
  502. <td class="mlabels-right">
  503. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  504. </tr>
  505. </table>
  506. </div><div class="memdoc">
  507. <p>Debug access to FAT table</p>
  508. <dl class="params"><dt>Parameters</dt><dd>
  509. <table class="params">
  510. <tr><td class="paramdir">[in]</td><td class="paramname">n</td><td>cluster number. </td></tr>
  511. <tr><td class="paramdir">[out]</td><td class="paramname">v</td><td>value of entry </td></tr>
  512. </table>
  513. </dd>
  514. </dl>
  515. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure </dd></dl>
  516. </div>
  517. </div>
  518. <a class="anchor" id="aee58c6352652f216577196e32a594b67"></a>
  519. <div class="memitem">
  520. <div class="memproto">
  521. <table class="mlabels">
  522. <tr>
  523. <td class="mlabels-left">
  524. <table class="memname">
  525. <tr>
  526. <td class="memname">bool FatFileSystem::exists </td>
  527. <td>(</td>
  528. <td class="paramtype">const char *&#160;</td>
  529. <td class="paramname"><em>path</em></td><td>)</td>
  530. <td></td>
  531. </tr>
  532. </table>
  533. </td>
  534. <td class="mlabels-right">
  535. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  536. </tr>
  537. </table>
  538. </div><div class="memdoc">
  539. <p>Test for the existence of a file.</p>
  540. <dl class="params"><dt>Parameters</dt><dd>
  541. <table class="params">
  542. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>Path of the file to be tested for.</td></tr>
  543. </table>
  544. </dd>
  545. </dl>
  546. <dl class="section return"><dt>Returns</dt><dd>true if the file exists else false. </dd></dl>
  547. </div>
  548. </div>
  549. <a class="anchor" id="acdedc6a200b01e401c9cd9b511eae6ec"></a>
  550. <div class="memitem">
  551. <div class="memproto">
  552. <table class="mlabels">
  553. <tr>
  554. <td class="mlabels-left">
  555. <table class="memname">
  556. <tr>
  557. <td class="memname">uint8_t FatVolume::fatCount </td>
  558. <td>(</td>
  559. <td class="paramname"></td><td>)</td>
  560. <td></td>
  561. </tr>
  562. </table>
  563. </td>
  564. <td class="mlabels-right">
  565. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  566. </tr>
  567. </table>
  568. </div><div class="memdoc">
  569. <dl class="section return"><dt>Returns</dt><dd>The number of <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> Allocation Tables. </dd></dl>
  570. </div>
  571. </div>
  572. <a class="anchor" id="a0dd0cc689b63ef0702aed1cf36b1722d"></a>
  573. <div class="memitem">
  574. <div class="memproto">
  575. <table class="mlabels">
  576. <tr>
  577. <td class="mlabels-left">
  578. <table class="memname">
  579. <tr>
  580. <td class="memname">uint32_t FatVolume::fatStartBlock </td>
  581. <td>(</td>
  582. <td class="paramname"></td><td>)</td>
  583. <td> const</td>
  584. </tr>
  585. </table>
  586. </td>
  587. <td class="mlabels-right">
  588. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  589. </tr>
  590. </table>
  591. </div><div class="memdoc">
  592. <dl class="section return"><dt>Returns</dt><dd>The logical block number for the start of the first FAT. </dd></dl>
  593. </div>
  594. </div>
  595. <a class="anchor" id="a1364f11fe9bb4717ce0685e2b7b86027"></a>
  596. <div class="memitem">
  597. <div class="memproto">
  598. <table class="mlabels">
  599. <tr>
  600. <td class="mlabels-left">
  601. <table class="memname">
  602. <tr>
  603. <td class="memname">uint8_t FatVolume::fatType </td>
  604. <td>(</td>
  605. <td class="paramname"></td><td>)</td>
  606. <td> const</td>
  607. </tr>
  608. </table>
  609. </td>
  610. <td class="mlabels-right">
  611. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  612. </tr>
  613. </table>
  614. </div><div class="memdoc">
  615. <dl class="section return"><dt>Returns</dt><dd>The FAT type of the volume. Values are 12, 16 or 32. </dd></dl>
  616. </div>
  617. </div>
  618. <a class="anchor" id="a1683b063fc6202ab85470b9610f16f93"></a>
  619. <div class="memitem">
  620. <div class="memproto">
  621. <table class="mlabels">
  622. <tr>
  623. <td class="mlabels-left">
  624. <table class="memname">
  625. <tr>
  626. <td class="memname">int32_t FatVolume::freeClusterCount </td>
  627. <td>(</td>
  628. <td class="paramname"></td><td>)</td>
  629. <td></td>
  630. </tr>
  631. </table>
  632. </td>
  633. <td class="mlabels-right">
  634. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  635. </tr>
  636. </table>
  637. </div><div class="memdoc">
  638. <p>Volume free space in clusters.</p>
  639. <dl class="section return"><dt>Returns</dt><dd>Count of free clusters for success or -1 if an error occurs. </dd></dl>
  640. </div>
  641. </div>
  642. <a class="anchor" id="acab819fa25a91dad1cc698a7e1e0eb32"></a>
  643. <div class="memitem">
  644. <div class="memproto">
  645. <table class="mlabels">
  646. <tr>
  647. <td class="mlabels-left">
  648. <table class="memname">
  649. <tr>
  650. <td class="memname">bool FatVolume::init </td>
  651. <td>(</td>
  652. <td class="paramname"></td><td>)</td>
  653. <td></td>
  654. </tr>
  655. </table>
  656. </td>
  657. <td class="mlabels-right">
  658. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  659. </tr>
  660. </table>
  661. </div><div class="memdoc">
  662. <p>Initialize a FAT volume. Try partition one first then try super floppy format.</p>
  663. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  664. </div>
  665. </div>
  666. <a class="anchor" id="a034d997a1e7a0b2b664a4357bcccd256"></a>
  667. <div class="memitem">
  668. <div class="memproto">
  669. <table class="mlabels">
  670. <tr>
  671. <td class="mlabels-left">
  672. <table class="memname">
  673. <tr>
  674. <td class="memname">bool FatVolume::init </td>
  675. <td>(</td>
  676. <td class="paramtype">uint8_t&#160;</td>
  677. <td class="paramname"><em>part</em></td><td>)</td>
  678. <td></td>
  679. </tr>
  680. </table>
  681. </td>
  682. <td class="mlabels-right">
  683. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  684. </tr>
  685. </table>
  686. </div><div class="memdoc">
  687. <p>Initialize a FAT volume.</p>
  688. <dl class="params"><dt>Parameters</dt><dd>
  689. <table class="params">
  690. <tr><td class="paramdir">[in]</td><td class="paramname">part</td><td>The partition to be used. Legal values for <em>part</em> are 1-4 to use the corresponding partition on a device formatted with a MBR, Master Boot Record, or zero if the device is formatted as a super floppy with the FAT boot sector in block zero.</td></tr>
  691. </table>
  692. </dd>
  693. </dl>
  694. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  695. </div>
  696. </div>
  697. <a class="anchor" id="a2398fb37a7a9d5e0dc0ffde6a44a993d"></a>
  698. <div class="memitem">
  699. <div class="memproto">
  700. <table class="mlabels">
  701. <tr>
  702. <td class="mlabels-left">
  703. <table class="memname">
  704. <tr>
  705. <td class="memname">void FatFileSystem::ls </td>
  706. <td>(</td>
  707. <td class="paramtype">uint8_t&#160;</td>
  708. <td class="paramname"><em>flags</em> = <code>0</code></td><td>)</td>
  709. <td></td>
  710. </tr>
  711. </table>
  712. </td>
  713. <td class="mlabels-right">
  714. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  715. </tr>
  716. </table>
  717. </div><div class="memdoc">
  718. <p>List the directory contents of the volume working directory to Serial.</p>
  719. <dl class="params"><dt>Parameters</dt><dd>
  720. <table class="params">
  721. <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>The inclusive OR of</td></tr>
  722. </table>
  723. </dd>
  724. </dl>
  725. <p>LS_DATE - Print file modification date</p>
  726. <p>LS_SIZE - Print file size.</p>
  727. <p>LS_R - Recursive list of subdirectories. </p>
  728. </div>
  729. </div>
  730. <a class="anchor" id="a122b61dbec5051304bcc81bc08b1b99d"></a>
  731. <div class="memitem">
  732. <div class="memproto">
  733. <table class="mlabels">
  734. <tr>
  735. <td class="mlabels-left">
  736. <table class="memname">
  737. <tr>
  738. <td class="memname">void FatFileSystem::ls </td>
  739. <td>(</td>
  740. <td class="paramtype">const char *&#160;</td>
  741. <td class="paramname"><em>path</em>, </td>
  742. </tr>
  743. <tr>
  744. <td class="paramkey"></td>
  745. <td></td>
  746. <td class="paramtype">uint8_t&#160;</td>
  747. <td class="paramname"><em>flags</em> = <code>0</code>&#160;</td>
  748. </tr>
  749. <tr>
  750. <td></td>
  751. <td>)</td>
  752. <td></td><td></td>
  753. </tr>
  754. </table>
  755. </td>
  756. <td class="mlabels-right">
  757. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  758. </tr>
  759. </table>
  760. </div><div class="memdoc">
  761. <p>List the directory contents of a directory to Serial.</p>
  762. <dl class="params"><dt>Parameters</dt><dd>
  763. <table class="params">
  764. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>directory to list.</td></tr>
  765. <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>The inclusive OR of</td></tr>
  766. </table>
  767. </dd>
  768. </dl>
  769. <p>LS_DATE - Print file modification date</p>
  770. <p>LS_SIZE - Print file size.</p>
  771. <p>LS_R - Recursive list of subdirectories. </p>
  772. </div>
  773. </div>
  774. <a class="anchor" id="ae12fb8bfad5c4a8e052dda70a5a0ed93"></a>
  775. <div class="memitem">
  776. <div class="memproto">
  777. <table class="mlabels">
  778. <tr>
  779. <td class="mlabels-left">
  780. <table class="memname">
  781. <tr>
  782. <td class="memname">void FatFileSystem::ls </td>
  783. <td>(</td>
  784. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  785. <td class="paramname"><em>pr</em>, </td>
  786. </tr>
  787. <tr>
  788. <td class="paramkey"></td>
  789. <td></td>
  790. <td class="paramtype">uint8_t&#160;</td>
  791. <td class="paramname"><em>flags</em> = <code>0</code>&#160;</td>
  792. </tr>
  793. <tr>
  794. <td></td>
  795. <td>)</td>
  796. <td></td><td></td>
  797. </tr>
  798. </table>
  799. </td>
  800. <td class="mlabels-right">
  801. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  802. </tr>
  803. </table>
  804. </div><div class="memdoc">
  805. <p>List the directory contents of the volume working directory.</p>
  806. <dl class="params"><dt>Parameters</dt><dd>
  807. <table class="params">
  808. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for list.</td></tr>
  809. <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>The inclusive OR of</td></tr>
  810. </table>
  811. </dd>
  812. </dl>
  813. <p>LS_DATE - Print file modification date</p>
  814. <p>LS_SIZE - Print file size.</p>
  815. <p>LS_R - Recursive list of subdirectories. </p>
  816. </div>
  817. </div>
  818. <a class="anchor" id="aa79695db8e910300507210b3067d39fd"></a>
  819. <div class="memitem">
  820. <div class="memproto">
  821. <table class="mlabels">
  822. <tr>
  823. <td class="mlabels-left">
  824. <table class="memname">
  825. <tr>
  826. <td class="memname">void FatFileSystem::ls </td>
  827. <td>(</td>
  828. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  829. <td class="paramname"><em>pr</em>, </td>
  830. </tr>
  831. <tr>
  832. <td class="paramkey"></td>
  833. <td></td>
  834. <td class="paramtype">const char *&#160;</td>
  835. <td class="paramname"><em>path</em>, </td>
  836. </tr>
  837. <tr>
  838. <td class="paramkey"></td>
  839. <td></td>
  840. <td class="paramtype">uint8_t&#160;</td>
  841. <td class="paramname"><em>flags</em>&#160;</td>
  842. </tr>
  843. <tr>
  844. <td></td>
  845. <td>)</td>
  846. <td></td><td></td>
  847. </tr>
  848. </table>
  849. </td>
  850. <td class="mlabels-right">
  851. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  852. </tr>
  853. </table>
  854. </div><div class="memdoc">
  855. <p>List the directory contents of a directory.</p>
  856. <dl class="params"><dt>Parameters</dt><dd>
  857. <table class="params">
  858. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for list.</td></tr>
  859. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>directory to list.</td></tr>
  860. <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>The inclusive OR of</td></tr>
  861. </table>
  862. </dd>
  863. </dl>
  864. <p>LS_DATE - Print file modification date</p>
  865. <p>LS_SIZE - Print file size.</p>
  866. <p>LS_R - Recursive list of subdirectories. </p>
  867. </div>
  868. </div>
  869. <a class="anchor" id="a231c62c98ba8ac3c2624dc5ad2053ebf"></a>
  870. <div class="memitem">
  871. <div class="memproto">
  872. <table class="mlabels">
  873. <tr>
  874. <td class="mlabels-left">
  875. <table class="memname">
  876. <tr>
  877. <td class="memname">bool FatFileSystem::mkdir </td>
  878. <td>(</td>
  879. <td class="paramtype">const char *&#160;</td>
  880. <td class="paramname"><em>path</em>, </td>
  881. </tr>
  882. <tr>
  883. <td class="paramkey"></td>
  884. <td></td>
  885. <td class="paramtype">bool&#160;</td>
  886. <td class="paramname"><em>pFlag</em> = <code>true</code>&#160;</td>
  887. </tr>
  888. <tr>
  889. <td></td>
  890. <td>)</td>
  891. <td></td><td></td>
  892. </tr>
  893. </table>
  894. </td>
  895. <td class="mlabels-right">
  896. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  897. </tr>
  898. </table>
  899. </div><div class="memdoc">
  900. <p>Make a subdirectory in the volume working directory.</p>
  901. <dl class="params"><dt>Parameters</dt><dd>
  902. <table class="params">
  903. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid 8.3 DOS name for the subdirectory.</td></tr>
  904. <tr><td class="paramdir">[in]</td><td class="paramname">pFlag</td><td>Create missing parent directories if true.</td></tr>
  905. </table>
  906. </dd>
  907. </dl>
  908. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  909. </div>
  910. </div>
  911. <a class="anchor" id="a947e4586077a922892b632edac33b67a"></a>
  912. <div class="memitem">
  913. <div class="memproto">
  914. <table class="mlabels">
  915. <tr>
  916. <td class="mlabels-left">
  917. <table class="memname">
  918. <tr>
  919. <td class="memname"><a class="el" href="class_file.html">File</a> FatFileSystem::open </td>
  920. <td>(</td>
  921. <td class="paramtype">const char *&#160;</td>
  922. <td class="paramname"><em>path</em>, </td>
  923. </tr>
  924. <tr>
  925. <td class="paramkey"></td>
  926. <td></td>
  927. <td class="paramtype">uint8_t&#160;</td>
  928. <td class="paramname"><em>mode</em> = <code><a class="el" href="_arduino_files_8h.html#ad52d51659a75e25d96fb04d22ff718cb">FILE_READ</a></code>&#160;</td>
  929. </tr>
  930. <tr>
  931. <td></td>
  932. <td>)</td>
  933. <td></td><td></td>
  934. </tr>
  935. </table>
  936. </td>
  937. <td class="mlabels-right">
  938. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  939. </tr>
  940. </table>
  941. </div><div class="memdoc">
  942. <p>open a file</p>
  943. <dl class="params"><dt>Parameters</dt><dd>
  944. <table class="params">
  945. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>location of file to be opened. </td></tr>
  946. <tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>open mode flags. </td></tr>
  947. </table>
  948. </dd>
  949. </dl>
  950. <dl class="section return"><dt>Returns</dt><dd>a <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> object. </dd></dl>
  951. </div>
  952. </div>
  953. <a class="anchor" id="a0abfb1f754a8fb559cfa884ee040f56f"></a>
  954. <div class="memitem">
  955. <div class="memproto">
  956. <table class="mlabels">
  957. <tr>
  958. <td class="mlabels-left">
  959. <table class="memname">
  960. <tr>
  961. <td class="memname"><a class="el" href="class_file.html">File</a> FatFileSystem::open </td>
  962. <td>(</td>
  963. <td class="paramtype">const String &amp;&#160;</td>
  964. <td class="paramname"><em>path</em>, </td>
  965. </tr>
  966. <tr>
  967. <td class="paramkey"></td>
  968. <td></td>
  969. <td class="paramtype">uint8_t&#160;</td>
  970. <td class="paramname"><em>mode</em> = <code><a class="el" href="_arduino_files_8h.html#ad52d51659a75e25d96fb04d22ff718cb">FILE_READ</a></code>&#160;</td>
  971. </tr>
  972. <tr>
  973. <td></td>
  974. <td>)</td>
  975. <td></td><td></td>
  976. </tr>
  977. </table>
  978. </td>
  979. <td class="mlabels-right">
  980. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  981. </tr>
  982. </table>
  983. </div><div class="memdoc">
  984. <p>open a file</p>
  985. <dl class="params"><dt>Parameters</dt><dd>
  986. <table class="params">
  987. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>location of file to be opened. </td></tr>
  988. <tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>open mode flags. </td></tr>
  989. </table>
  990. </dd>
  991. </dl>
  992. <dl class="section return"><dt>Returns</dt><dd>a <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> object. </dd></dl>
  993. </div>
  994. </div>
  995. <a class="anchor" id="abf7d7d0dab43083d5be10d70ff4669e4"></a>
  996. <div class="memitem">
  997. <div class="memproto">
  998. <table class="mlabels">
  999. <tr>
  1000. <td class="mlabels-left">
  1001. <table class="memname">
  1002. <tr>
  1003. <td class="memname">bool FatFileSystem::remove </td>
  1004. <td>(</td>
  1005. <td class="paramtype">const char *&#160;</td>
  1006. <td class="paramname"><em>path</em></td><td>)</td>
  1007. <td></td>
  1008. </tr>
  1009. </table>
  1010. </td>
  1011. <td class="mlabels-right">
  1012. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1013. </tr>
  1014. </table>
  1015. </div><div class="memdoc">
  1016. <p>Remove a file from the volume working directory.</p>
  1017. <dl class="params"><dt>Parameters</dt><dd>
  1018. <table class="params">
  1019. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid 8.3 DOS name for the file.</td></tr>
  1020. </table>
  1021. </dd>
  1022. </dl>
  1023. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  1024. </div>
  1025. </div>
  1026. <a class="anchor" id="a0187891a24017b41bd7c5ba63e659e65"></a>
  1027. <div class="memitem">
  1028. <div class="memproto">
  1029. <table class="mlabels">
  1030. <tr>
  1031. <td class="mlabels-left">
  1032. <table class="memname">
  1033. <tr>
  1034. <td class="memname">bool FatFileSystem::rename </td>
  1035. <td>(</td>
  1036. <td class="paramtype">const char *&#160;</td>
  1037. <td class="paramname"><em>oldPath</em>, </td>
  1038. </tr>
  1039. <tr>
  1040. <td class="paramkey"></td>
  1041. <td></td>
  1042. <td class="paramtype">const char *&#160;</td>
  1043. <td class="paramname"><em>newPath</em>&#160;</td>
  1044. </tr>
  1045. <tr>
  1046. <td></td>
  1047. <td>)</td>
  1048. <td></td><td></td>
  1049. </tr>
  1050. </table>
  1051. </td>
  1052. <td class="mlabels-right">
  1053. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1054. </tr>
  1055. </table>
  1056. </div><div class="memdoc">
  1057. <p>Rename a file or subdirectory.</p>
  1058. <dl class="params"><dt>Parameters</dt><dd>
  1059. <table class="params">
  1060. <tr><td class="paramdir">[in]</td><td class="paramname">oldPath</td><td>Path name to the file or subdirectory to be renamed.</td></tr>
  1061. <tr><td class="paramdir">[in]</td><td class="paramname">newPath</td><td>New path name of the file or subdirectory.</td></tr>
  1062. </table>
  1063. </dd>
  1064. </dl>
  1065. <p>The <em>newPath</em> object must not exist before the rename call.</p>
  1066. <p>The file to be renamed must not be open. The directory entry may be moved and file system corruption could occur if the file is accessed by a file object that was opened before the <a class="el" href="class_fat_file_system.html#a0187891a24017b41bd7c5ba63e659e65">rename()</a> call.</p>
  1067. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  1068. </div>
  1069. </div>
  1070. <a class="anchor" id="aaed2edc7ff7fedb163458c870bb41b33"></a>
  1071. <div class="memitem">
  1072. <div class="memproto">
  1073. <table class="mlabels">
  1074. <tr>
  1075. <td class="mlabels-left">
  1076. <table class="memname">
  1077. <tr>
  1078. <td class="memname">bool FatFileSystem::rmdir </td>
  1079. <td>(</td>
  1080. <td class="paramtype">const char *&#160;</td>
  1081. <td class="paramname"><em>path</em></td><td>)</td>
  1082. <td></td>
  1083. </tr>
  1084. </table>
  1085. </td>
  1086. <td class="mlabels-right">
  1087. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1088. </tr>
  1089. </table>
  1090. </div><div class="memdoc">
  1091. <p>Remove a subdirectory from the volume's working directory.</p>
  1092. <dl class="params"><dt>Parameters</dt><dd>
  1093. <table class="params">
  1094. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid 8.3 DOS name for the subdirectory.</td></tr>
  1095. </table>
  1096. </dd>
  1097. </dl>
  1098. <p>The subdirectory file will be removed only if it is empty.</p>
  1099. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  1100. </div>
  1101. </div>
  1102. <a class="anchor" id="ab2d483670a0a6a6a4754b23614fe11bc"></a>
  1103. <div class="memitem">
  1104. <div class="memproto">
  1105. <table class="mlabels">
  1106. <tr>
  1107. <td class="mlabels-left">
  1108. <table class="memname">
  1109. <tr>
  1110. <td class="memname">uint16_t FatVolume::rootDirEntryCount </td>
  1111. <td>(</td>
  1112. <td class="paramname"></td><td>)</td>
  1113. <td> const</td>
  1114. </tr>
  1115. </table>
  1116. </td>
  1117. <td class="mlabels-right">
  1118. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1119. </tr>
  1120. </table>
  1121. </div><div class="memdoc">
  1122. <dl class="section return"><dt>Returns</dt><dd>The number of entries in the root directory for FAT16 volumes. </dd></dl>
  1123. </div>
  1124. </div>
  1125. <a class="anchor" id="ae9363ebbbae90e895ea56e8fa3f60c13"></a>
  1126. <div class="memitem">
  1127. <div class="memproto">
  1128. <table class="mlabels">
  1129. <tr>
  1130. <td class="mlabels-left">
  1131. <table class="memname">
  1132. <tr>
  1133. <td class="memname">uint32_t FatVolume::rootDirStart </td>
  1134. <td>(</td>
  1135. <td class="paramname"></td><td>)</td>
  1136. <td> const</td>
  1137. </tr>
  1138. </table>
  1139. </td>
  1140. <td class="mlabels-right">
  1141. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1142. </tr>
  1143. </table>
  1144. </div><div class="memdoc">
  1145. <dl class="section return"><dt>Returns</dt><dd>The logical block number for the start of the root directory on FAT16 volumes or the first cluster number on FAT32 volumes. </dd></dl>
  1146. </div>
  1147. </div>
  1148. <a class="anchor" id="ad60cb13557f35578f868e03e9ccb8be1"></a>
  1149. <div class="memitem">
  1150. <div class="memproto">
  1151. <table class="mlabels">
  1152. <tr>
  1153. <td class="mlabels-left">
  1154. <table class="memname">
  1155. <tr>
  1156. <td class="memname">bool FatFileSystem::truncate </td>
  1157. <td>(</td>
  1158. <td class="paramtype">const char *&#160;</td>
  1159. <td class="paramname"><em>path</em>, </td>
  1160. </tr>
  1161. <tr>
  1162. <td class="paramkey"></td>
  1163. <td></td>
  1164. <td class="paramtype">uint32_t&#160;</td>
  1165. <td class="paramname"><em>length</em>&#160;</td>
  1166. </tr>
  1167. <tr>
  1168. <td></td>
  1169. <td>)</td>
  1170. <td></td><td></td>
  1171. </tr>
  1172. </table>
  1173. </td>
  1174. <td class="mlabels-right">
  1175. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1176. </tr>
  1177. </table>
  1178. </div><div class="memdoc">
  1179. <p>Truncate a file to a specified length. The current file position will be maintained if it is less than or equal to <em>length</em> otherwise it will be set to end of file.</p>
  1180. <dl class="params"><dt>Parameters</dt><dd>
  1181. <table class="params">
  1182. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid 8.3 DOS name for the file. </td></tr>
  1183. <tr><td class="paramdir">[in]</td><td class="paramname">length</td><td>The desired length for the file.</td></tr>
  1184. </table>
  1185. </dd>
  1186. </dl>
  1187. <dl class="section return"><dt>Returns</dt><dd>The value true is returned for success and the value false is returned for failure. </dd></dl>
  1188. </div>
  1189. </div>
  1190. <a class="anchor" id="a4ca68fe47bb675df0a80df1ed7a53698"></a>
  1191. <div class="memitem">
  1192. <div class="memproto">
  1193. <table class="mlabels">
  1194. <tr>
  1195. <td class="mlabels-left">
  1196. <table class="memname">
  1197. <tr>
  1198. <td class="memname"><a class="el" href="class_fat_volume.html">FatVolume</a>* FatFileSystem::vol </td>
  1199. <td>(</td>
  1200. <td class="paramname"></td><td>)</td>
  1201. <td></td>
  1202. </tr>
  1203. </table>
  1204. </td>
  1205. <td class="mlabels-right">
  1206. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1207. </tr>
  1208. </table>
  1209. </div><div class="memdoc">
  1210. <dl class="section return"><dt>Returns</dt><dd>a pointer to the <a class="el" href="class_fat_volume.html" title="Access FAT16 and FAT32 volumes on raw file devices. ">FatVolume</a> object. </dd></dl>
  1211. </div>
  1212. </div>
  1213. <a class="anchor" id="a07bc98088ce4a9c725700899c184f7fc"></a>
  1214. <div class="memitem">
  1215. <div class="memproto">
  1216. <table class="mlabels">
  1217. <tr>
  1218. <td class="mlabels-left">
  1219. <table class="memname">
  1220. <tr>
  1221. <td class="memname">uint32_t FatVolume::volumeBlockCount </td>
  1222. <td>(</td>
  1223. <td class="paramname"></td><td>)</td>
  1224. <td> const</td>
  1225. </tr>
  1226. </table>
  1227. </td>
  1228. <td class="mlabels-right">
  1229. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1230. </tr>
  1231. </table>
  1232. </div><div class="memdoc">
  1233. <dl class="section return"><dt>Returns</dt><dd>The number of blocks in the volume </dd></dl>
  1234. </div>
  1235. </div>
  1236. <a class="anchor" id="acf257d02b7166683bda2abc5058004bf"></a>
  1237. <div class="memitem">
  1238. <div class="memproto">
  1239. <table class="mlabels">
  1240. <tr>
  1241. <td class="mlabels-left">
  1242. <table class="memname">
  1243. <tr>
  1244. <td class="memname"><a class="el" href="class_fat_file.html">FatFile</a>* FatFileSystem::vwd </td>
  1245. <td>(</td>
  1246. <td class="paramname"></td><td>)</td>
  1247. <td></td>
  1248. </tr>
  1249. </table>
  1250. </td>
  1251. <td class="mlabels-right">
  1252. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1253. </tr>
  1254. </table>
  1255. </div><div class="memdoc">
  1256. <dl class="section return"><dt>Returns</dt><dd>a pointer to the volume working directory. </dd></dl>
  1257. </div>
  1258. </div>
  1259. <a class="anchor" id="a36d7831f92acfbfef1c4a24dd7103dc4"></a>
  1260. <div class="memitem">
  1261. <div class="memproto">
  1262. <table class="mlabels">
  1263. <tr>
  1264. <td class="mlabels-left">
  1265. <table class="memname">
  1266. <tr>
  1267. <td class="memname">bool FatFileSystem::wipe </td>
  1268. <td>(</td>
  1269. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  1270. <td class="paramname"><em>pr</em> = <code>0</code></td><td>)</td>
  1271. <td></td>
  1272. </tr>
  1273. </table>
  1274. </td>
  1275. <td class="mlabels-right">
  1276. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1277. </tr>
  1278. </table>
  1279. </div><div class="memdoc">
  1280. <p>Wipe all data from the volume. You must reinitialize the volume before accessing it again. </p><dl class="params"><dt>Parameters</dt><dd>
  1281. <table class="params">
  1282. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>print stream for status dots. </td></tr>
  1283. </table>
  1284. </dd>
  1285. </dl>
  1286. <dl class="section return"><dt>Returns</dt><dd>true for success else false. </dd></dl>
  1287. </div>
  1288. </div>
  1289. <hr/>The documentation for this class was generated from the following file:<ul>
  1290. <li>Arduino/libraries/SdFat/src/FatLib/<a class="el" href="_fat_file_system_8h.html">FatFileSystem.h</a></li>
  1291. </ul>
  1292. </div><!-- contents -->
  1293. <!-- start footer part -->
  1294. <hr class="footer"/><address class="footer"><small>
  1295. Generated on Mon Sep 5 2016 10:18:52 for SdFat by &#160;<a href="http://www.doxygen.org/index.html">
  1296. <img class="footer" src="doxygen.png" alt="doxygen"/>
  1297. </a> 1.8.10
  1298. </small></address>
  1299. </body>
  1300. </html>