Du kannst nicht mehr als 25 Themen auswählen Themen müssen entweder mit einem Buchstaben oder einer Ziffer beginnen. Sie können Bindestriche („-“) enthalten und bis zu 35 Zeichen lang sein.

3586 Zeilen
157KB

  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: File 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="#pub-static-methods">Static Public Member Functions</a> &#124;
  85. <a href="class_file-members.html">List of all members</a> </div>
  86. <div class="headertitle">
  87. <div class="title">File Class Reference</div> </div>
  88. </div><!--header-->
  89. <div class="contents">
  90. <p>Arduino SD.h style <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> API.
  91. <a href="class_file.html#details">More...</a></p>
  92. <p><code>#include &lt;ArduinoFiles.h&gt;</code></p>
  93. <div class="dynheader">
  94. Inheritance diagram for File:</div>
  95. <div class="dyncontent">
  96. <div class="center"><img src="class_file__inherit__graph.png" border="0" usemap="#_file_inherit__map" alt="Inheritance graph"/></div>
  97. <map name="_file_inherit__map" id="_file_inherit__map">
  98. <area shape="rect" id="node2" href="class_fat_file.html" title="Basic file class. " alt="" coords="5,5,68,32"/>
  99. </map>
  100. <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
  101. <div class="dynheader">
  102. Collaboration diagram for File:</div>
  103. <div class="dyncontent">
  104. <div class="center"><img src="class_file__coll__graph.png" border="0" usemap="#_file_coll__map" alt="Collaboration graph"/></div>
  105. <map name="_file_coll__map" id="_file_coll__map">
  106. <area shape="rect" id="node2" href="class_fat_file.html" title="Basic file class. " alt="" coords="5,5,68,32"/>
  107. </map>
  108. <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
  109. <table class="memberdecls">
  110. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  111. Public Member Functions</h2></td></tr>
  112. <tr class="memitem:acf613c4e75bae85f543b30e701ebcc44"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#acf613c4e75bae85f543b30e701ebcc44">available</a> ()</td></tr>
  113. <tr class="separator:acf613c4e75bae85f543b30e701ebcc44"><td class="memSeparator" colspan="2">&#160;</td></tr>
  114. <tr class="memitem:a052e2c15a39b322a5307b693b8835b22"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a052e2c15a39b322a5307b693b8835b22">clearError</a> ()</td></tr>
  115. <tr class="separator:a052e2c15a39b322a5307b693b8835b22"><td class="memSeparator" colspan="2">&#160;</td></tr>
  116. <tr class="memitem:aeca2a2eff91e6aa55fe1b0e3860c9a05"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aeca2a2eff91e6aa55fe1b0e3860c9a05">clearWriteError</a> ()</td></tr>
  117. <tr class="separator:aeca2a2eff91e6aa55fe1b0e3860c9a05"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <tr class="memitem:afd16af325e0642e4bff6430b7d8bb18b"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#afd16af325e0642e4bff6430b7d8bb18b">close</a> ()</td></tr>
  119. <tr class="separator:afd16af325e0642e4bff6430b7d8bb18b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  120. <tr class="memitem:aa367708bcc8bc0e0c45c0c2a812c65da"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aa367708bcc8bc0e0c45c0c2a812c65da">contiguousRange</a> (uint32_t *bgnBlock, uint32_t *endBlock)</td></tr>
  121. <tr class="separator:aa367708bcc8bc0e0c45c0c2a812c65da"><td class="memSeparator" colspan="2">&#160;</td></tr>
  122. <tr class="memitem:a0afc2a1cffa238d1cb2049bfa2d8d199"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a0afc2a1cffa238d1cb2049bfa2d8d199">createContiguous</a> (<a class="el" href="class_fat_file.html">FatFile</a> *dirFile, const char *path, uint32_t <a class="el" href="class_file.html#a603d3cd3319142d00a7ebd434970b017">size</a>)</td></tr>
  123. <tr class="separator:a0afc2a1cffa238d1cb2049bfa2d8d199"><td class="memSeparator" colspan="2">&#160;</td></tr>
  124. <tr class="memitem:a0853fbd44aee2798d14d8e3aed78f8bf"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a0853fbd44aee2798d14d8e3aed78f8bf">createContiguous</a> (const char *path, uint32_t <a class="el" href="class_file.html#a603d3cd3319142d00a7ebd434970b017">size</a>)</td></tr>
  125. <tr class="separator:a0853fbd44aee2798d14d8e3aed78f8bf"><td class="memSeparator" colspan="2">&#160;</td></tr>
  126. <tr class="memitem:a4c03e2f6729526786e6ab4a623e0339b"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a4c03e2f6729526786e6ab4a623e0339b">curCluster</a> () const </td></tr>
  127. <tr class="separator:a4c03e2f6729526786e6ab4a623e0339b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  128. <tr class="memitem:a20c55b134bfd1d287a00bf64eba9332e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a20c55b134bfd1d287a00bf64eba9332e">curPosition</a> () const </td></tr>
  129. <tr class="separator:a20c55b134bfd1d287a00bf64eba9332e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  130. <tr class="memitem:a6858d18c807411a071fd6d1b39d50087"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a6858d18c807411a071fd6d1b39d50087">dirEntry</a> (<a class="el" href="_fat_structs_8h.html#a803db59d4e16a0c54a647afc6a7954e3">dir_t</a> *dir)</td></tr>
  131. <tr class="separator:a6858d18c807411a071fd6d1b39d50087"><td class="memSeparator" colspan="2">&#160;</td></tr>
  132. <tr class="memitem:ae5ec24d4a94d3780384d3f2b731c7eb9"><td class="memItemLeft" align="right" valign="top">uint16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ae5ec24d4a94d3780384d3f2b731c7eb9">dirIndex</a> ()</td></tr>
  133. <tr class="separator:ae5ec24d4a94d3780384d3f2b731c7eb9"><td class="memSeparator" colspan="2">&#160;</td></tr>
  134. <tr class="memitem:ae2ed15f05c9ccbce355e7a8d3ce8382d"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ae2ed15f05c9ccbce355e7a8d3ce8382d">dirSize</a> ()</td></tr>
  135. <tr class="separator:ae2ed15f05c9ccbce355e7a8d3ce8382d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  136. <tr class="memitem:a4f01d27954ae49aeb6888ac7302f55d9"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a4f01d27954ae49aeb6888ac7302f55d9">dmpFile</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr, uint32_t pos, size_t n)</td></tr>
  137. <tr class="separator:a4f01d27954ae49aeb6888ac7302f55d9"><td class="memSeparator" colspan="2">&#160;</td></tr>
  138. <tr class="memitem:a50242f98dea0d4488ce4039a279f2a57"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a50242f98dea0d4488ce4039a279f2a57">exists</a> (const char *path)</td></tr>
  139. <tr class="separator:a50242f98dea0d4488ce4039a279f2a57"><td class="memSeparator" colspan="2">&#160;</td></tr>
  140. <tr class="memitem:a31ef26b3ee37cf5f5f4c6024c0ddab69"><td class="memItemLeft" align="right" valign="top">int16_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a31ef26b3ee37cf5f5f4c6024c0ddab69">fgets</a> (char *str, int16_t num, char *delim=0)</td></tr>
  141. <tr class="separator:a31ef26b3ee37cf5f5f4c6024c0ddab69"><td class="memSeparator" colspan="2">&#160;</td></tr>
  142. <tr class="memitem:a9ecb14efb960d1369926182479f56213"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a9ecb14efb960d1369926182479f56213">File</a> (const char *path, uint8_t oflag)</td></tr>
  143. <tr class="separator:a9ecb14efb960d1369926182479f56213"><td class="memSeparator" colspan="2">&#160;</td></tr>
  144. <tr class="memitem:a7e043dfb89d268bfd620bbbadacf1002"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a7e043dfb89d268bfd620bbbadacf1002">fileAttr</a> () const </td></tr>
  145. <tr class="separator:a7e043dfb89d268bfd620bbbadacf1002"><td class="memSeparator" colspan="2">&#160;</td></tr>
  146. <tr class="memitem:a02fc3b3ca36b4745f695f3de8c8ec36d"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a02fc3b3ca36b4745f695f3de8c8ec36d">fileSize</a> () const </td></tr>
  147. <tr class="separator:a02fc3b3ca36b4745f695f3de8c8ec36d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  148. <tr class="memitem:ac87b753811e540c7b799da56fa89724b"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ac87b753811e540c7b799da56fa89724b">firstBlock</a> ()</td></tr>
  149. <tr class="separator:ac87b753811e540c7b799da56fa89724b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  150. <tr class="memitem:a1057bc23b92a074539f661e896e79a09"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a1057bc23b92a074539f661e896e79a09">firstCluster</a> () const </td></tr>
  151. <tr class="separator:a1057bc23b92a074539f661e896e79a09"><td class="memSeparator" colspan="2">&#160;</td></tr>
  152. <tr class="memitem:af87fa862de707575b8badd044a5af80e"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#af87fa862de707575b8badd044a5af80e">flush</a> ()</td></tr>
  153. <tr class="separator:af87fa862de707575b8badd044a5af80e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  154. <tr class="memitem:ad0dbbd083180f44c7a3ce7124d4ce19c"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ad0dbbd083180f44c7a3ce7124d4ce19c">getError</a> ()</td></tr>
  155. <tr class="separator:ad0dbbd083180f44c7a3ce7124d4ce19c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  156. <tr class="memitem:aafa565e286440aab612cdb430fc01da5"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aafa565e286440aab612cdb430fc01da5">getName</a> (char *<a class="el" href="class_file.html#a7ca23d8d3997c10c221977c64736f575">name</a>, size_t <a class="el" href="class_file.html#a603d3cd3319142d00a7ebd434970b017">size</a>)</td></tr>
  157. <tr class="separator:aafa565e286440aab612cdb430fc01da5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  158. <tr class="memitem:aaa4f9886887947815a61eaf015996932"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aaa4f9886887947815a61eaf015996932">getpos</a> (<a class="el" href="struct_fat_pos__t.html">FatPos_t</a> *pos)</td></tr>
  159. <tr class="separator:aaa4f9886887947815a61eaf015996932"><td class="memSeparator" colspan="2">&#160;</td></tr>
  160. <tr class="memitem:aba30e92a66f8e0d2f815c85662772a58"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aba30e92a66f8e0d2f815c85662772a58">getSFN</a> (char *<a class="el" href="class_file.html#a7ca23d8d3997c10c221977c64736f575">name</a>)</td></tr>
  161. <tr class="separator:aba30e92a66f8e0d2f815c85662772a58"><td class="memSeparator" colspan="2">&#160;</td></tr>
  162. <tr class="memitem:a8062c0d3a118e8d77d0310418703d5f5"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a8062c0d3a118e8d77d0310418703d5f5">getWriteError</a> ()</td></tr>
  163. <tr class="separator:a8062c0d3a118e8d77d0310418703d5f5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  164. <tr class="memitem:aef41d65e0f1ce753d18cc9ed691f7de4"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aef41d65e0f1ce753d18cc9ed691f7de4">isDir</a> () const </td></tr>
  165. <tr class="separator:aef41d65e0f1ce753d18cc9ed691f7de4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  166. <tr class="memitem:a6ba5bdb943363cda56649238ccb18c27"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a6ba5bdb943363cda56649238ccb18c27">isDirectory</a> ()</td></tr>
  167. <tr class="separator:a6ba5bdb943363cda56649238ccb18c27"><td class="memSeparator" colspan="2">&#160;</td></tr>
  168. <tr class="memitem:afcf6270ea8d4a3a5f8e89523bc684e22"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#afcf6270ea8d4a3a5f8e89523bc684e22">isFile</a> () const </td></tr>
  169. <tr class="separator:afcf6270ea8d4a3a5f8e89523bc684e22"><td class="memSeparator" colspan="2">&#160;</td></tr>
  170. <tr class="memitem:a7eefe7408f34b6326f0c6e78af7eb05f"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a7eefe7408f34b6326f0c6e78af7eb05f">isHidden</a> () const </td></tr>
  171. <tr class="separator:a7eefe7408f34b6326f0c6e78af7eb05f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  172. <tr class="memitem:aed36d17f8fde597b6ed9446faec1f7e3"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aed36d17f8fde597b6ed9446faec1f7e3">isLFN</a> () const </td></tr>
  173. <tr class="separator:aed36d17f8fde597b6ed9446faec1f7e3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  174. <tr class="memitem:a4c8a07b081f04aa25839c6f56c739bdc"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a4c8a07b081f04aa25839c6f56c739bdc">isOpen</a> () const </td></tr>
  175. <tr class="separator:a4c8a07b081f04aa25839c6f56c739bdc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  176. <tr class="memitem:a6872d3acb1e70f81c9c2be2495977583"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a6872d3acb1e70f81c9c2be2495977583">isReadOnly</a> () const </td></tr>
  177. <tr class="separator:a6872d3acb1e70f81c9c2be2495977583"><td class="memSeparator" colspan="2">&#160;</td></tr>
  178. <tr class="memitem:aa4a206803a4bf8243be20244c1aef4d2"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aa4a206803a4bf8243be20244c1aef4d2">isRoot</a> () const </td></tr>
  179. <tr class="separator:aa4a206803a4bf8243be20244c1aef4d2"><td class="memSeparator" colspan="2">&#160;</td></tr>
  180. <tr class="memitem:a1449b294e3a838396c62e47674ca8cf0"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a1449b294e3a838396c62e47674ca8cf0">isRoot32</a> () const </td></tr>
  181. <tr class="separator:a1449b294e3a838396c62e47674ca8cf0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  182. <tr class="memitem:a8215bd4b21e11ec83fa88ef226ceb06f"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a8215bd4b21e11ec83fa88ef226ceb06f">isRootFixed</a> () const </td></tr>
  183. <tr class="separator:a8215bd4b21e11ec83fa88ef226ceb06f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  184. <tr class="memitem:a95b503b17442c2b364a2f53de1b2aeba"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a95b503b17442c2b364a2f53de1b2aeba">isSubDir</a> () const </td></tr>
  185. <tr class="separator:a95b503b17442c2b364a2f53de1b2aeba"><td class="memSeparator" colspan="2">&#160;</td></tr>
  186. <tr class="memitem:add932e13e5bf32ad467af6ec34824e3c"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#add932e13e5bf32ad467af6ec34824e3c">isSystem</a> () const </td></tr>
  187. <tr class="separator:add932e13e5bf32ad467af6ec34824e3c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  188. <tr class="memitem:ad49f688a494b351ccbb0102dcfafb925"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ad49f688a494b351ccbb0102dcfafb925">ls</a> (uint8_t flags=0)</td></tr>
  189. <tr class="separator:ad49f688a494b351ccbb0102dcfafb925"><td class="memSeparator" colspan="2">&#160;</td></tr>
  190. <tr class="memitem:acabf31ff85e696fbf384c49428012fea"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#acabf31ff85e696fbf384c49428012fea">ls</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr, uint8_t flags=0, uint8_t indent=0)</td></tr>
  191. <tr class="separator:acabf31ff85e696fbf384c49428012fea"><td class="memSeparator" colspan="2">&#160;</td></tr>
  192. <tr class="memitem:abab5b9f72cc796388dd4eed01d13d90d"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#abab5b9f72cc796388dd4eed01d13d90d">mkdir</a> (<a class="el" href="class_fat_file.html">FatFile</a> *dir, const char *path, bool pFlag=true)</td></tr>
  193. <tr class="separator:abab5b9f72cc796388dd4eed01d13d90d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  194. <tr class="memitem:a7ca23d8d3997c10c221977c64736f575"><td class="memItemLeft" align="right" valign="top">const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a7ca23d8d3997c10c221977c64736f575">name</a> () const </td></tr>
  195. <tr class="separator:a7ca23d8d3997c10c221977c64736f575"><td class="memSeparator" colspan="2">&#160;</td></tr>
  196. <tr class="memitem:a5f64576d3d19177ab3cf3812b69abdfa"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a5f64576d3d19177ab3cf3812b69abdfa">open</a> (<a class="el" href="class_fat_file_system.html">FatFileSystem</a> *fs, const char *path, uint8_t oflag)</td></tr>
  197. <tr class="separator:a5f64576d3d19177ab3cf3812b69abdfa"><td class="memSeparator" colspan="2">&#160;</td></tr>
  198. <tr class="memitem:ad3fa9daaccb4e4179fb88a8ca037aa80"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ad3fa9daaccb4e4179fb88a8ca037aa80">open</a> (<a class="el" href="class_fat_file.html">FatFile</a> *dirFile, uint16_t index, uint8_t oflag)</td></tr>
  199. <tr class="separator:ad3fa9daaccb4e4179fb88a8ca037aa80"><td class="memSeparator" colspan="2">&#160;</td></tr>
  200. <tr class="memitem:a211be757679b18708f6b6a36464e4f61"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a211be757679b18708f6b6a36464e4f61">open</a> (<a class="el" href="class_fat_file.html">FatFile</a> *dirFile, const char *path, uint8_t oflag)</td></tr>
  201. <tr class="separator:a211be757679b18708f6b6a36464e4f61"><td class="memSeparator" colspan="2">&#160;</td></tr>
  202. <tr class="memitem:ab0e7075062c89f356441f80fc64d03e6"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ab0e7075062c89f356441f80fc64d03e6">open</a> (const char *path, uint8_t oflag=O_READ)</td></tr>
  203. <tr class="separator:ab0e7075062c89f356441f80fc64d03e6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  204. <tr class="memitem:a8034c4649eb0d26715b1a8a69e73d9d0"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a8034c4649eb0d26715b1a8a69e73d9d0">openNext</a> (<a class="el" href="class_fat_file.html">FatFile</a> *dirFile, uint8_t oflag=O_READ)</td></tr>
  205. <tr class="separator:a8034c4649eb0d26715b1a8a69e73d9d0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  206. <tr class="memitem:acd72000ab1f6a1ce73ac8fbdc854ae0c"><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_file.html#acd72000ab1f6a1ce73ac8fbdc854ae0c">openNextFile</a> (uint8_t mode=O_READ)</td></tr>
  207. <tr class="separator:acd72000ab1f6a1ce73ac8fbdc854ae0c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  208. <tr class="memitem:a7e0c0548fed3a69e7284b91b694439d4"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a7e0c0548fed3a69e7284b91b694439d4">openRoot</a> (<a class="el" href="class_fat_volume.html">FatVolume</a> *vol)</td></tr>
  209. <tr class="separator:a7e0c0548fed3a69e7284b91b694439d4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  210. <tr class="memitem:af171fbf441c899cf71d88b8b0b83d38b"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#af171fbf441c899cf71d88b8b0b83d38b">operator bool</a> ()</td></tr>
  211. <tr class="separator:af171fbf441c899cf71d88b8b0b83d38b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  212. <tr class="memitem:a0e5025f39bd584563bfe4b05fc1db268"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a0e5025f39bd584563bfe4b05fc1db268">peek</a> ()</td></tr>
  213. <tr class="separator:a0e5025f39bd584563bfe4b05fc1db268"><td class="memSeparator" colspan="2">&#160;</td></tr>
  214. <tr class="memitem:aae991c597c0bc4c5eb44c1f3b06a21ec"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#aae991c597c0bc4c5eb44c1f3b06a21ec">position</a> ()</td></tr>
  215. <tr class="separator:aae991c597c0bc4c5eb44c1f3b06a21ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
  216. <tr class="memitem:a558530f20314a8d8ee3d1a488fc7f46e"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a558530f20314a8d8ee3d1a488fc7f46e">printCreateDateTime</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  217. <tr class="separator:a558530f20314a8d8ee3d1a488fc7f46e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  218. <tr class="memitem:a7478cad0f9e5079311b9e1fa558016ff"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a7478cad0f9e5079311b9e1fa558016ff">printField</a> (float value, char term, uint8_t prec=2)</td></tr>
  219. <tr class="separator:a7478cad0f9e5079311b9e1fa558016ff"><td class="memSeparator" colspan="2">&#160;</td></tr>
  220. <tr class="memitem:abd3e1747511216462b3ef98167156cbb"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#abd3e1747511216462b3ef98167156cbb">printField</a> (int16_t value, char term)</td></tr>
  221. <tr class="separator:abd3e1747511216462b3ef98167156cbb"><td class="memSeparator" colspan="2">&#160;</td></tr>
  222. <tr class="memitem:a9972c2419c293ef9c382bff666b9ae4d"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a9972c2419c293ef9c382bff666b9ae4d">printField</a> (uint16_t value, char term)</td></tr>
  223. <tr class="separator:a9972c2419c293ef9c382bff666b9ae4d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  224. <tr class="memitem:a41b3b32dd8482429b74c7af3432d6cf8"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a41b3b32dd8482429b74c7af3432d6cf8">printField</a> (int32_t value, char term)</td></tr>
  225. <tr class="separator:a41b3b32dd8482429b74c7af3432d6cf8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  226. <tr class="memitem:a097240f08baadeb1c64b63eab9afb088"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a097240f08baadeb1c64b63eab9afb088">printField</a> (uint32_t value, char term)</td></tr>
  227. <tr class="separator:a097240f08baadeb1c64b63eab9afb088"><td class="memSeparator" colspan="2">&#160;</td></tr>
  228. <tr class="memitem:a12a5d2de2737c201aa39ca1bd2ab9c47"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a12a5d2de2737c201aa39ca1bd2ab9c47">printFileSize</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  229. <tr class="separator:a12a5d2de2737c201aa39ca1bd2ab9c47"><td class="memSeparator" colspan="2">&#160;</td></tr>
  230. <tr class="memitem:a05cee5df46a370bf916d3ba597c82e39"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a05cee5df46a370bf916d3ba597c82e39">printModifyDateTime</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  231. <tr class="separator:a05cee5df46a370bf916d3ba597c82e39"><td class="memSeparator" colspan="2">&#160;</td></tr>
  232. <tr class="memitem:ad1cbc3aeb0f5193b7a26595966da9621"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ad1cbc3aeb0f5193b7a26595966da9621">printName</a> ()</td></tr>
  233. <tr class="separator:ad1cbc3aeb0f5193b7a26595966da9621"><td class="memSeparator" colspan="2">&#160;</td></tr>
  234. <tr class="memitem:afe18a787fb8640e2d2483370c770f82f"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#afe18a787fb8640e2d2483370c770f82f">printName</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  235. <tr class="separator:afe18a787fb8640e2d2483370c770f82f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  236. <tr class="memitem:a791cd7aade71f609aab62ec018aea3c0"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a791cd7aade71f609aab62ec018aea3c0">printSFN</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  237. <tr class="separator:a791cd7aade71f609aab62ec018aea3c0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  238. <tr class="memitem:a4c46a1975e66c37977bf07c58ec10b4e"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a4c46a1975e66c37977bf07c58ec10b4e">read</a> ()</td></tr>
  239. <tr class="separator:a4c46a1975e66c37977bf07c58ec10b4e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  240. <tr class="memitem:a200e6e0553d5b709520c9dfac9ef77dd"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a200e6e0553d5b709520c9dfac9ef77dd">read</a> (void *buf, size_t nbyte)</td></tr>
  241. <tr class="separator:a200e6e0553d5b709520c9dfac9ef77dd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  242. <tr class="memitem:a1325afe074c3efecff666678cd9f116a"><td class="memItemLeft" align="right" valign="top">int8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a1325afe074c3efecff666678cd9f116a">readDir</a> (<a class="el" href="_fat_structs_8h.html#a803db59d4e16a0c54a647afc6a7954e3">dir_t</a> *dir)</td></tr>
  243. <tr class="separator:a1325afe074c3efecff666678cd9f116a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  244. <tr class="memitem:ac837a537fbcca14c7aa390c5fc9f4e7c"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ac837a537fbcca14c7aa390c5fc9f4e7c">remove</a> ()</td></tr>
  245. <tr class="separator:ac837a537fbcca14c7aa390c5fc9f4e7c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  246. <tr class="memitem:a4b42f2454ff462555c07ea094a92a1e0"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a4b42f2454ff462555c07ea094a92a1e0">rename</a> (<a class="el" href="class_fat_file.html">FatFile</a> *dirFile, const char *newPath)</td></tr>
  247. <tr class="separator:a4b42f2454ff462555c07ea094a92a1e0"><td class="memSeparator" colspan="2">&#160;</td></tr>
  248. <tr class="memitem:a5aac6e0b3cb08fc8b8668e916a8b0ca5"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a5aac6e0b3cb08fc8b8668e916a8b0ca5">rewind</a> ()</td></tr>
  249. <tr class="separator:a5aac6e0b3cb08fc8b8668e916a8b0ca5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  250. <tr class="memitem:ae1419603dea25a6c8480b941d7ac63a3"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#ae1419603dea25a6c8480b941d7ac63a3">rewindDirectory</a> ()</td></tr>
  251. <tr class="separator:ae1419603dea25a6c8480b941d7ac63a3"><td class="memSeparator" colspan="2">&#160;</td></tr>
  252. <tr class="memitem:a9515bac181d33e7f0125e88fa2ccd283"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a9515bac181d33e7f0125e88fa2ccd283">rmdir</a> ()</td></tr>
  253. <tr class="separator:a9515bac181d33e7f0125e88fa2ccd283"><td class="memSeparator" colspan="2">&#160;</td></tr>
  254. <tr class="memitem:ac780a80526f86d3def701ecdc99d8bfe"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ac780a80526f86d3def701ecdc99d8bfe">rmRfStar</a> ()</td></tr>
  255. <tr class="separator:ac780a80526f86d3def701ecdc99d8bfe"><td class="memSeparator" colspan="2">&#160;</td></tr>
  256. <tr class="memitem:a2d41ea52356b769e05e1242685758c08"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a2d41ea52356b769e05e1242685758c08">seek</a> (uint32_t pos)</td></tr>
  257. <tr class="separator:a2d41ea52356b769e05e1242685758c08"><td class="memSeparator" colspan="2">&#160;</td></tr>
  258. <tr class="memitem:a5812037ea30777cc350698ad26f2c73f"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a5812037ea30777cc350698ad26f2c73f">seekCur</a> (int32_t offset)</td></tr>
  259. <tr class="separator:a5812037ea30777cc350698ad26f2c73f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  260. <tr class="memitem:a84f677f4e75ef6fa2eb632f4cdf6b486"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a84f677f4e75ef6fa2eb632f4cdf6b486">seekEnd</a> (int32_t offset=0)</td></tr>
  261. <tr class="separator:a84f677f4e75ef6fa2eb632f4cdf6b486"><td class="memSeparator" colspan="2">&#160;</td></tr>
  262. <tr class="memitem:ab067190d25733ed7e697d9890f61fd7a"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ab067190d25733ed7e697d9890f61fd7a">seekSet</a> (uint32_t pos)</td></tr>
  263. <tr class="separator:ab067190d25733ed7e697d9890f61fd7a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  264. <tr class="memitem:acf264de4e3ca36c5e8a39e56173c9044"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#acf264de4e3ca36c5e8a39e56173c9044">setpos</a> (<a class="el" href="struct_fat_pos__t.html">FatPos_t</a> *pos)</td></tr>
  265. <tr class="separator:acf264de4e3ca36c5e8a39e56173c9044"><td class="memSeparator" colspan="2">&#160;</td></tr>
  266. <tr class="memitem:a603d3cd3319142d00a7ebd434970b017"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a603d3cd3319142d00a7ebd434970b017">size</a> ()</td></tr>
  267. <tr class="separator:a603d3cd3319142d00a7ebd434970b017"><td class="memSeparator" colspan="2">&#160;</td></tr>
  268. <tr class="memitem:a67f3dc4896c542d695e11aac927f585e"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a67f3dc4896c542d695e11aac927f585e">sync</a> ()</td></tr>
  269. <tr class="separator:a67f3dc4896c542d695e11aac927f585e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  270. <tr class="memitem:aa53a8d1d2467ad9af7d61cbf8ee85243"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aa53a8d1d2467ad9af7d61cbf8ee85243">timestamp</a> (<a class="el" href="class_fat_file.html">FatFile</a> *file)</td></tr>
  271. <tr class="separator:aa53a8d1d2467ad9af7d61cbf8ee85243"><td class="memSeparator" colspan="2">&#160;</td></tr>
  272. <tr class="memitem:a56dabdf73833b7e961c4530eb8e16d23"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a56dabdf73833b7e961c4530eb8e16d23">timestamp</a> (uint8_t flags, uint16_t year, uint8_t month, uint8_t day, uint8_t hour, uint8_t minute, uint8_t second)</td></tr>
  273. <tr class="separator:a56dabdf73833b7e961c4530eb8e16d23"><td class="memSeparator" colspan="2">&#160;</td></tr>
  274. <tr class="memitem:aa6e663098a578635d37d92e82d18d616"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aa6e663098a578635d37d92e82d18d616">truncate</a> (uint32_t length)</td></tr>
  275. <tr class="separator:aa6e663098a578635d37d92e82d18d616"><td class="memSeparator" colspan="2">&#160;</td></tr>
  276. <tr class="memitem:a3c64bd8a9abb9a6461d4addb405614df"><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.html#a3c64bd8a9abb9a6461d4addb405614df">volume</a> () const </td></tr>
  277. <tr class="separator:a3c64bd8a9abb9a6461d4addb405614df"><td class="memSeparator" colspan="2">&#160;</td></tr>
  278. <tr class="memitem:a618a6b2b7e81bfb93e0d3c158f614f90"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a618a6b2b7e81bfb93e0d3c158f614f90">write</a> (uint8_t b)</td></tr>
  279. <tr class="separator:a618a6b2b7e81bfb93e0d3c158f614f90"><td class="memSeparator" colspan="2">&#160;</td></tr>
  280. <tr class="memitem:aa531c1641a2363e1f6b9d103f37433da"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#aa531c1641a2363e1f6b9d103f37433da">write</a> (const uint8_t *buf, size_t <a class="el" href="class_file.html#a603d3cd3319142d00a7ebd434970b017">size</a>)</td></tr>
  281. <tr class="separator:aa531c1641a2363e1f6b9d103f37433da"><td class="memSeparator" colspan="2">&#160;</td></tr>
  282. <tr class="memitem:aa4a5b81161994cea07938702cdfce49f"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#aa4a5b81161994cea07938702cdfce49f">write</a> (const char *str)</td></tr>
  283. <tr class="separator:aa4a5b81161994cea07938702cdfce49f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  284. <tr class="memitem:a0ab9df44a9ee4b6eb0a78f15f1e30004"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a0ab9df44a9ee4b6eb0a78f15f1e30004">write</a> (const void *buf, size_t nbyte)</td></tr>
  285. <tr class="separator:a0ab9df44a9ee4b6eb0a78f15f1e30004"><td class="memSeparator" colspan="2">&#160;</td></tr>
  286. </table><table class="memberdecls">
  287. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a>
  288. Static Public Member Functions</h2></td></tr>
  289. <tr class="memitem:a3b68e603ad8e47bad915f0547e580adb"><td class="memItemLeft" align="right" valign="top">static <a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a3b68e603ad8e47bad915f0547e580adb">cwd</a> ()</td></tr>
  290. <tr class="separator:a3b68e603ad8e47bad915f0547e580adb"><td class="memSeparator" colspan="2">&#160;</td></tr>
  291. <tr class="memitem:a29a623f50df057e8b49045ba6611ec2b"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a29a623f50df057e8b49045ba6611ec2b">dateTimeCallback</a> (void(*dateTime)(uint16_t *date, uint16_t *time))</td></tr>
  292. <tr class="separator:a29a623f50df057e8b49045ba6611ec2b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  293. <tr class="memitem:a5df02f1d037e6091375488af25244ebc"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a5df02f1d037e6091375488af25244ebc">dateTimeCallbackCancel</a> ()</td></tr>
  294. <tr class="separator:a5df02f1d037e6091375488af25244ebc"><td class="memSeparator" colspan="2">&#160;</td></tr>
  295. <tr class="memitem:a648461081fe07578780f4cd3f246cb66"><td class="memItemLeft" align="right" valign="top">static uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a648461081fe07578780f4cd3f246cb66">dirName</a> (const <a class="el" href="_fat_structs_8h.html#a803db59d4e16a0c54a647afc6a7954e3">dir_t</a> *dir, char *<a class="el" href="class_file.html#a7ca23d8d3997c10c221977c64736f575">name</a>)</td></tr>
  296. <tr class="separator:a648461081fe07578780f4cd3f246cb66"><td class="memSeparator" colspan="2">&#160;</td></tr>
  297. <tr class="memitem:a94df8090f16e9666cdc53ca20f6aff90"><td class="memItemLeft" align="right" valign="top">static bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a94df8090f16e9666cdc53ca20f6aff90">legal83Char</a> (uint8_t c)</td></tr>
  298. <tr class="separator:a94df8090f16e9666cdc53ca20f6aff90"><td class="memSeparator" colspan="2">&#160;</td></tr>
  299. <tr class="memitem:a8fdb038aafdf3a17ac80b53c063aa73b"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a8fdb038aafdf3a17ac80b53c063aa73b">printFatDate</a> (uint16_t fatDate)</td></tr>
  300. <tr class="separator:a8fdb038aafdf3a17ac80b53c063aa73b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  301. <tr class="memitem:ada5364f66204b1a64afbf9d2e6cd2b0b"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#ada5364f66204b1a64afbf9d2e6cd2b0b">printFatDate</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr, uint16_t fatDate)</td></tr>
  302. <tr class="separator:ada5364f66204b1a64afbf9d2e6cd2b0b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  303. <tr class="memitem:a7740731f08ef97de7dfbc9b075c4c7d1"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a7740731f08ef97de7dfbc9b075c4c7d1">printFatTime</a> (uint16_t fatTime)</td></tr>
  304. <tr class="separator:a7740731f08ef97de7dfbc9b075c4c7d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  305. <tr class="memitem:a4e7e56ba52ca17c602af1b85684b09a9"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a4e7e56ba52ca17c602af1b85684b09a9">printFatTime</a> (<a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr, uint16_t fatTime)</td></tr>
  306. <tr class="separator:a4e7e56ba52ca17c602af1b85684b09a9"><td class="memSeparator" colspan="2">&#160;</td></tr>
  307. <tr class="memitem:afe820bbb056863e91ec482961c8dc695"><td class="memItemLeft" align="right" valign="top">static bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#afe820bbb056863e91ec482961c8dc695">remove</a> (<a class="el" href="class_fat_file.html">FatFile</a> *dirFile, const char *path)</td></tr>
  308. <tr class="separator:afe820bbb056863e91ec482961c8dc695"><td class="memSeparator" colspan="2">&#160;</td></tr>
  309. <tr class="memitem:a360ef9c05e677271bed6c0a4d663634c"><td class="memItemLeft" align="right" valign="top">static bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_fat_file.html#a360ef9c05e677271bed6c0a4d663634c">setCwd</a> (<a class="el" href="class_fat_file.html">FatFile</a> *dir)</td></tr>
  310. <tr class="separator:a360ef9c05e677271bed6c0a4d663634c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  311. </table>
  312. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  313. <div class="textblock"><p>Arduino SD.h style <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> API. </p>
  314. </div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  315. <a class="anchor" id="a9ecb14efb960d1369926182479f56213"></a>
  316. <div class="memitem">
  317. <div class="memproto">
  318. <table class="mlabels">
  319. <tr>
  320. <td class="mlabels-left">
  321. <table class="memname">
  322. <tr>
  323. <td class="memname">File::File </td>
  324. <td>(</td>
  325. <td class="paramtype">const char *&#160;</td>
  326. <td class="paramname"><em>path</em>, </td>
  327. </tr>
  328. <tr>
  329. <td class="paramkey"></td>
  330. <td></td>
  331. <td class="paramtype">uint8_t&#160;</td>
  332. <td class="paramname"><em>oflag</em>&#160;</td>
  333. </tr>
  334. <tr>
  335. <td></td>
  336. <td>)</td>
  337. <td></td><td></td>
  338. </tr>
  339. </table>
  340. </td>
  341. <td class="mlabels-right">
  342. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  343. </tr>
  344. </table>
  345. </div><div class="memdoc">
  346. <p>Create a file object and open it in the current working directory.</p>
  347. <dl class="params"><dt>Parameters</dt><dd>
  348. <table class="params">
  349. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid 8.3 DOS name for a file to be opened.</td></tr>
  350. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>Values for <em>oflag</em> are constructed by a bitwise-inclusive OR of open flags. see <a class="el" href="class_fat_file.html#a211be757679b18708f6b6a36464e4f61">FatFile::open(FatFile*, const char*, uint8_t)</a>. </td></tr>
  351. </table>
  352. </dd>
  353. </dl>
  354. </div>
  355. </div>
  356. <h2 class="groupheader">Member Function Documentation</h2>
  357. <a class="anchor" id="acf613c4e75bae85f543b30e701ebcc44"></a>
  358. <div class="memitem">
  359. <div class="memproto">
  360. <table class="mlabels">
  361. <tr>
  362. <td class="mlabels-left">
  363. <table class="memname">
  364. <tr>
  365. <td class="memname">int File::available </td>
  366. <td>(</td>
  367. <td class="paramname"></td><td>)</td>
  368. <td></td>
  369. </tr>
  370. </table>
  371. </td>
  372. <td class="mlabels-right">
  373. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  374. </tr>
  375. </table>
  376. </div><div class="memdoc">
  377. <dl class="section return"><dt>Returns</dt><dd>number of bytes available from the current position to EOF or INT_MAX if more than INT_MAX bytes are available. </dd></dl>
  378. </div>
  379. </div>
  380. <a class="anchor" id="a052e2c15a39b322a5307b693b8835b22"></a>
  381. <div class="memitem">
  382. <div class="memproto">
  383. <table class="mlabels">
  384. <tr>
  385. <td class="mlabels-left">
  386. <table class="memname">
  387. <tr>
  388. <td class="memname">void FatFile::clearError </td>
  389. <td>(</td>
  390. <td class="paramname"></td><td>)</td>
  391. <td></td>
  392. </tr>
  393. </table>
  394. </td>
  395. <td class="mlabels-right">
  396. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  397. </tr>
  398. </table>
  399. </div><div class="memdoc">
  400. <p>Clear all error bits. </p>
  401. </div>
  402. </div>
  403. <a class="anchor" id="aeca2a2eff91e6aa55fe1b0e3860c9a05"></a>
  404. <div class="memitem">
  405. <div class="memproto">
  406. <table class="mlabels">
  407. <tr>
  408. <td class="mlabels-left">
  409. <table class="memname">
  410. <tr>
  411. <td class="memname">void FatFile::clearWriteError </td>
  412. <td>(</td>
  413. <td class="paramname"></td><td>)</td>
  414. <td></td>
  415. </tr>
  416. </table>
  417. </td>
  418. <td class="mlabels-right">
  419. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  420. </tr>
  421. </table>
  422. </div><div class="memdoc">
  423. <p>Set writeError to zero </p>
  424. </div>
  425. </div>
  426. <a class="anchor" id="afd16af325e0642e4bff6430b7d8bb18b"></a>
  427. <div class="memitem">
  428. <div class="memproto">
  429. <table class="mlabels">
  430. <tr>
  431. <td class="mlabels-left">
  432. <table class="memname">
  433. <tr>
  434. <td class="memname">bool FatFile::close </td>
  435. <td>(</td>
  436. <td class="paramname"></td><td>)</td>
  437. <td></td>
  438. </tr>
  439. </table>
  440. </td>
  441. <td class="mlabels-right">
  442. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  443. </tr>
  444. </table>
  445. </div><div class="memdoc">
  446. <p>Close a file and force cached data and directory information to be written to the storage device.</p>
  447. <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>
  448. </div>
  449. </div>
  450. <a class="anchor" id="aa367708bcc8bc0e0c45c0c2a812c65da"></a>
  451. <div class="memitem">
  452. <div class="memproto">
  453. <table class="mlabels">
  454. <tr>
  455. <td class="mlabels-left">
  456. <table class="memname">
  457. <tr>
  458. <td class="memname">bool FatFile::contiguousRange </td>
  459. <td>(</td>
  460. <td class="paramtype">uint32_t *&#160;</td>
  461. <td class="paramname"><em>bgnBlock</em>, </td>
  462. </tr>
  463. <tr>
  464. <td class="paramkey"></td>
  465. <td></td>
  466. <td class="paramtype">uint32_t *&#160;</td>
  467. <td class="paramname"><em>endBlock</em>&#160;</td>
  468. </tr>
  469. <tr>
  470. <td></td>
  471. <td>)</td>
  472. <td></td><td></td>
  473. </tr>
  474. </table>
  475. </td>
  476. <td class="mlabels-right">
  477. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  478. </tr>
  479. </table>
  480. </div><div class="memdoc">
  481. <p>Check for contiguous file and return its raw block range.</p>
  482. <dl class="params"><dt>Parameters</dt><dd>
  483. <table class="params">
  484. <tr><td class="paramdir">[out]</td><td class="paramname">bgnBlock</td><td>the first block address for the file. </td></tr>
  485. <tr><td class="paramdir">[out]</td><td class="paramname">endBlock</td><td>the last block address for the file.</td></tr>
  486. </table>
  487. </dd>
  488. </dl>
  489. <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>
  490. </div>
  491. </div>
  492. <a class="anchor" id="a0afc2a1cffa238d1cb2049bfa2d8d199"></a>
  493. <div class="memitem">
  494. <div class="memproto">
  495. <table class="mlabels">
  496. <tr>
  497. <td class="mlabels-left">
  498. <table class="memname">
  499. <tr>
  500. <td class="memname">bool FatFile::createContiguous </td>
  501. <td>(</td>
  502. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  503. <td class="paramname"><em>dirFile</em>, </td>
  504. </tr>
  505. <tr>
  506. <td class="paramkey"></td>
  507. <td></td>
  508. <td class="paramtype">const char *&#160;</td>
  509. <td class="paramname"><em>path</em>, </td>
  510. </tr>
  511. <tr>
  512. <td class="paramkey"></td>
  513. <td></td>
  514. <td class="paramtype">uint32_t&#160;</td>
  515. <td class="paramname"><em>size</em>&#160;</td>
  516. </tr>
  517. <tr>
  518. <td></td>
  519. <td>)</td>
  520. <td></td><td></td>
  521. </tr>
  522. </table>
  523. </td>
  524. <td class="mlabels-right">
  525. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  526. </tr>
  527. </table>
  528. </div><div class="memdoc">
  529. <p>Create and open a new contiguous file of a specified size.</p>
  530. <dl class="params"><dt>Parameters</dt><dd>
  531. <table class="params">
  532. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>The directory where the file will be created. </td></tr>
  533. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a validfile name. </td></tr>
  534. <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The desired file size.</td></tr>
  535. </table>
  536. </dd>
  537. </dl>
  538. <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>
  539. </div>
  540. </div>
  541. <a class="anchor" id="a0853fbd44aee2798d14d8e3aed78f8bf"></a>
  542. <div class="memitem">
  543. <div class="memproto">
  544. <table class="mlabels">
  545. <tr>
  546. <td class="mlabels-left">
  547. <table class="memname">
  548. <tr>
  549. <td class="memname">bool FatFile::createContiguous </td>
  550. <td>(</td>
  551. <td class="paramtype">const char *&#160;</td>
  552. <td class="paramname"><em>path</em>, </td>
  553. </tr>
  554. <tr>
  555. <td class="paramkey"></td>
  556. <td></td>
  557. <td class="paramtype">uint32_t&#160;</td>
  558. <td class="paramname"><em>size</em>&#160;</td>
  559. </tr>
  560. <tr>
  561. <td></td>
  562. <td>)</td>
  563. <td></td><td></td>
  564. </tr>
  565. </table>
  566. </td>
  567. <td class="mlabels-right">
  568. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  569. </tr>
  570. </table>
  571. </div><div class="memdoc">
  572. <p>Create and open a new contiguous file of a specified size.</p>
  573. <dl class="params"><dt>Parameters</dt><dd>
  574. <table class="params">
  575. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a validfile name. </td></tr>
  576. <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The desired file size.</td></tr>
  577. </table>
  578. </dd>
  579. </dl>
  580. <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>
  581. </div>
  582. </div>
  583. <a class="anchor" id="a4c03e2f6729526786e6ab4a623e0339b"></a>
  584. <div class="memitem">
  585. <div class="memproto">
  586. <table class="mlabels">
  587. <tr>
  588. <td class="mlabels-left">
  589. <table class="memname">
  590. <tr>
  591. <td class="memname">uint32_t FatFile::curCluster </td>
  592. <td>(</td>
  593. <td class="paramname"></td><td>)</td>
  594. <td> const</td>
  595. </tr>
  596. </table>
  597. </td>
  598. <td class="mlabels-right">
  599. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  600. </tr>
  601. </table>
  602. </div><div class="memdoc">
  603. <dl class="section return"><dt>Returns</dt><dd>The current cluster number for a file or directory. </dd></dl>
  604. </div>
  605. </div>
  606. <a class="anchor" id="a20c55b134bfd1d287a00bf64eba9332e"></a>
  607. <div class="memitem">
  608. <div class="memproto">
  609. <table class="mlabels">
  610. <tr>
  611. <td class="mlabels-left">
  612. <table class="memname">
  613. <tr>
  614. <td class="memname">uint32_t FatFile::curPosition </td>
  615. <td>(</td>
  616. <td class="paramname"></td><td>)</td>
  617. <td> const</td>
  618. </tr>
  619. </table>
  620. </td>
  621. <td class="mlabels-right">
  622. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  623. </tr>
  624. </table>
  625. </div><div class="memdoc">
  626. <dl class="section return"><dt>Returns</dt><dd>The current position for a file or directory. </dd></dl>
  627. </div>
  628. </div>
  629. <a class="anchor" id="a3b68e603ad8e47bad915f0547e580adb"></a>
  630. <div class="memitem">
  631. <div class="memproto">
  632. <table class="mlabels">
  633. <tr>
  634. <td class="mlabels-left">
  635. <table class="memname">
  636. <tr>
  637. <td class="memname">static <a class="el" href="class_fat_file.html">FatFile</a>* FatFile::cwd </td>
  638. <td>(</td>
  639. <td class="paramname"></td><td>)</td>
  640. <td></td>
  641. </tr>
  642. </table>
  643. </td>
  644. <td class="mlabels-right">
  645. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  646. </tr>
  647. </table>
  648. </div><div class="memdoc">
  649. <dl class="section return"><dt>Returns</dt><dd>Current working directory </dd></dl>
  650. </div>
  651. </div>
  652. <a class="anchor" id="a29a623f50df057e8b49045ba6611ec2b"></a>
  653. <div class="memitem">
  654. <div class="memproto">
  655. <table class="mlabels">
  656. <tr>
  657. <td class="mlabels-left">
  658. <table class="memname">
  659. <tr>
  660. <td class="memname">static void FatFile::dateTimeCallback </td>
  661. <td>(</td>
  662. <td class="paramtype">void(*)(uint16_t *date, uint16_t *time)&#160;</td>
  663. <td class="paramname"><em>dateTime</em></td><td>)</td>
  664. <td></td>
  665. </tr>
  666. </table>
  667. </td>
  668. <td class="mlabels-right">
  669. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  670. </tr>
  671. </table>
  672. </div><div class="memdoc">
  673. <p>Set the date/time callback function</p>
  674. <dl class="params"><dt>Parameters</dt><dd>
  675. <table class="params">
  676. <tr><td class="paramdir">[in]</td><td class="paramname">dateTime</td><td>The user's call back function. The callback function is of the form:</td></tr>
  677. </table>
  678. </dd>
  679. </dl>
  680. <div class="fragment"><div class="line"><span class="keywordtype">void</span> dateTime(uint16_t* date, uint16_t* time) {</div>
  681. <div class="line"> uint16_t year;</div>
  682. <div class="line"> uint8_t month, day, hour, minute, second;</div>
  683. <div class="line"></div>
  684. <div class="line"> <span class="comment">// User gets date and time from GPS or real-time clock here</span></div>
  685. <div class="line"></div>
  686. <div class="line"> <span class="comment">// return date using FAT_DATE macro to format fields</span></div>
  687. <div class="line"> *date = <a class="code" href="_fat_structs_8h.html#a44899ad42ddf32ff1c1a73b5251b304a">FAT_DATE</a>(year, month, day);</div>
  688. <div class="line"></div>
  689. <div class="line"> <span class="comment">// return time using FAT_TIME macro to format fields</span></div>
  690. <div class="line"> *time = <a class="code" href="_fat_structs_8h.html#a375720927be5a39475d48b2d75dae29a">FAT_TIME</a>(hour, minute, second);</div>
  691. <div class="line">}</div>
  692. </div><!-- fragment --><p>Sets the function that is called when a file is created or when a file's directory entry is modified by <a class="el" href="class_fat_file.html#a67f3dc4896c542d695e11aac927f585e">sync()</a>. All timestamps, access, creation, and modify, are set when a file is created. <a class="el" href="class_fat_file.html#a67f3dc4896c542d695e11aac927f585e">sync()</a> maintains the last access date and last modify date/time.</p>
  693. <p>See the <a class="el" href="class_fat_file.html#aa53a8d1d2467ad9af7d61cbf8ee85243">timestamp()</a> function. </p>
  694. </div>
  695. </div>
  696. <a class="anchor" id="a5df02f1d037e6091375488af25244ebc"></a>
  697. <div class="memitem">
  698. <div class="memproto">
  699. <table class="mlabels">
  700. <tr>
  701. <td class="mlabels-left">
  702. <table class="memname">
  703. <tr>
  704. <td class="memname">static void FatFile::dateTimeCallbackCancel </td>
  705. <td>(</td>
  706. <td class="paramname"></td><td>)</td>
  707. <td></td>
  708. </tr>
  709. </table>
  710. </td>
  711. <td class="mlabels-right">
  712. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  713. </tr>
  714. </table>
  715. </div><div class="memdoc">
  716. <p>Cancel the date/time callback function. </p>
  717. </div>
  718. </div>
  719. <a class="anchor" id="a6858d18c807411a071fd6d1b39d50087"></a>
  720. <div class="memitem">
  721. <div class="memproto">
  722. <table class="mlabels">
  723. <tr>
  724. <td class="mlabels-left">
  725. <table class="memname">
  726. <tr>
  727. <td class="memname">bool FatFile::dirEntry </td>
  728. <td>(</td>
  729. <td class="paramtype"><a class="el" href="_fat_structs_8h.html#a803db59d4e16a0c54a647afc6a7954e3">dir_t</a> *&#160;</td>
  730. <td class="paramname"><em>dir</em></td><td>)</td>
  731. <td></td>
  732. </tr>
  733. </table>
  734. </td>
  735. <td class="mlabels-right">
  736. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  737. </tr>
  738. </table>
  739. </div><div class="memdoc">
  740. <p>Return a file's directory entry.</p>
  741. <dl class="params"><dt>Parameters</dt><dd>
  742. <table class="params">
  743. <tr><td class="paramdir">[out]</td><td class="paramname">dir</td><td>Location for return of the file's directory entry.</td></tr>
  744. </table>
  745. </dd>
  746. </dl>
  747. <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>
  748. </div>
  749. </div>
  750. <a class="anchor" id="ae5ec24d4a94d3780384d3f2b731c7eb9"></a>
  751. <div class="memitem">
  752. <div class="memproto">
  753. <table class="mlabels">
  754. <tr>
  755. <td class="mlabels-left">
  756. <table class="memname">
  757. <tr>
  758. <td class="memname">uint16_t FatFile::dirIndex </td>
  759. <td>(</td>
  760. <td class="paramname"></td><td>)</td>
  761. <td></td>
  762. </tr>
  763. </table>
  764. </td>
  765. <td class="mlabels-right">
  766. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  767. </tr>
  768. </table>
  769. </div><div class="memdoc">
  770. <dl class="section return"><dt>Returns</dt><dd>The index of this file in it's directory. </dd></dl>
  771. </div>
  772. </div>
  773. <a class="anchor" id="a648461081fe07578780f4cd3f246cb66"></a>
  774. <div class="memitem">
  775. <div class="memproto">
  776. <table class="mlabels">
  777. <tr>
  778. <td class="mlabels-left">
  779. <table class="memname">
  780. <tr>
  781. <td class="memname">uint8_t FatFile::dirName </td>
  782. <td>(</td>
  783. <td class="paramtype">const <a class="el" href="_fat_structs_8h.html#a803db59d4e16a0c54a647afc6a7954e3">dir_t</a> *&#160;</td>
  784. <td class="paramname"><em>dir</em>, </td>
  785. </tr>
  786. <tr>
  787. <td class="paramkey"></td>
  788. <td></td>
  789. <td class="paramtype">char *&#160;</td>
  790. <td class="paramname"><em>name</em>&#160;</td>
  791. </tr>
  792. <tr>
  793. <td></td>
  794. <td>)</td>
  795. <td></td><td></td>
  796. </tr>
  797. </table>
  798. </td>
  799. <td class="mlabels-right">
  800. <span class="mlabels"><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  801. </tr>
  802. </table>
  803. </div><div class="memdoc">
  804. <p>Format the name field of <em>dir</em> into the 13 byte array <em>name</em> in standard 8.3 short name format.</p>
  805. <dl class="params"><dt>Parameters</dt><dd>
  806. <table class="params">
  807. <tr><td class="paramdir">[in]</td><td class="paramname">dir</td><td>The directory structure containing the name. </td></tr>
  808. <tr><td class="paramdir">[out]</td><td class="paramname">name</td><td>A 13 byte char array for the formatted name. </td></tr>
  809. </table>
  810. </dd>
  811. </dl>
  812. <dl class="section return"><dt>Returns</dt><dd>length of the name. </dd></dl>
  813. </div>
  814. </div>
  815. <a class="anchor" id="ae2ed15f05c9ccbce355e7a8d3ce8382d"></a>
  816. <div class="memitem">
  817. <div class="memproto">
  818. <table class="mlabels">
  819. <tr>
  820. <td class="mlabels-left">
  821. <table class="memname">
  822. <tr>
  823. <td class="memname">uint32_t FatFile::dirSize </td>
  824. <td>(</td>
  825. <td class="paramname"></td><td>)</td>
  826. <td></td>
  827. </tr>
  828. </table>
  829. </td>
  830. <td class="mlabels-right">
  831. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  832. </tr>
  833. </table>
  834. </div><div class="memdoc">
  835. <dl class="section return"><dt>Returns</dt><dd>The number of bytes allocated to a directory or zero if an error occurs. </dd></dl>
  836. </div>
  837. </div>
  838. <a class="anchor" id="a4f01d27954ae49aeb6888ac7302f55d9"></a>
  839. <div class="memitem">
  840. <div class="memproto">
  841. <table class="mlabels">
  842. <tr>
  843. <td class="mlabels-left">
  844. <table class="memname">
  845. <tr>
  846. <td class="memname">void FatFile::dmpFile </td>
  847. <td>(</td>
  848. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  849. <td class="paramname"><em>pr</em>, </td>
  850. </tr>
  851. <tr>
  852. <td class="paramkey"></td>
  853. <td></td>
  854. <td class="paramtype">uint32_t&#160;</td>
  855. <td class="paramname"><em>pos</em>, </td>
  856. </tr>
  857. <tr>
  858. <td class="paramkey"></td>
  859. <td></td>
  860. <td class="paramtype">size_t&#160;</td>
  861. <td class="paramname"><em>n</em>&#160;</td>
  862. </tr>
  863. <tr>
  864. <td></td>
  865. <td>)</td>
  866. <td></td><td></td>
  867. </tr>
  868. </table>
  869. </td>
  870. <td class="mlabels-right">
  871. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  872. </tr>
  873. </table>
  874. </div><div class="memdoc">
  875. <p>Dump file in Hex </p><dl class="params"><dt>Parameters</dt><dd>
  876. <table class="params">
  877. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for list. </td></tr>
  878. <tr><td class="paramdir">[in]</td><td class="paramname">pos</td><td>Start position in file. </td></tr>
  879. <tr><td class="paramdir">[in]</td><td class="paramname">n</td><td>number of locations to dump. </td></tr>
  880. </table>
  881. </dd>
  882. </dl>
  883. </div>
  884. </div>
  885. <a class="anchor" id="a50242f98dea0d4488ce4039a279f2a57"></a>
  886. <div class="memitem">
  887. <div class="memproto">
  888. <table class="mlabels">
  889. <tr>
  890. <td class="mlabels-left">
  891. <table class="memname">
  892. <tr>
  893. <td class="memname">bool FatFile::exists </td>
  894. <td>(</td>
  895. <td class="paramtype">const char *&#160;</td>
  896. <td class="paramname"><em>path</em></td><td>)</td>
  897. <td></td>
  898. </tr>
  899. </table>
  900. </td>
  901. <td class="mlabels-right">
  902. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  903. </tr>
  904. </table>
  905. </div><div class="memdoc">
  906. <p>Test for the existence of a file in a directory</p>
  907. <dl class="params"><dt>Parameters</dt><dd>
  908. <table class="params">
  909. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>Path of the file to be tested for.</td></tr>
  910. </table>
  911. </dd>
  912. </dl>
  913. <p>The calling instance must be an open directory file.</p>
  914. <p>dirFile.exists("TOFIND.TXT") searches for "TOFIND.TXT" in the directory dirFile.</p>
  915. <dl class="section return"><dt>Returns</dt><dd>true if the file exists else false. </dd></dl>
  916. </div>
  917. </div>
  918. <a class="anchor" id="a31ef26b3ee37cf5f5f4c6024c0ddab69"></a>
  919. <div class="memitem">
  920. <div class="memproto">
  921. <table class="mlabels">
  922. <tr>
  923. <td class="mlabels-left">
  924. <table class="memname">
  925. <tr>
  926. <td class="memname">int16_t FatFile::fgets </td>
  927. <td>(</td>
  928. <td class="paramtype">char *&#160;</td>
  929. <td class="paramname"><em>str</em>, </td>
  930. </tr>
  931. <tr>
  932. <td class="paramkey"></td>
  933. <td></td>
  934. <td class="paramtype">int16_t&#160;</td>
  935. <td class="paramname"><em>num</em>, </td>
  936. </tr>
  937. <tr>
  938. <td class="paramkey"></td>
  939. <td></td>
  940. <td class="paramtype">char *&#160;</td>
  941. <td class="paramname"><em>delim</em> = <code>0</code>&#160;</td>
  942. </tr>
  943. <tr>
  944. <td></td>
  945. <td>)</td>
  946. <td></td><td></td>
  947. </tr>
  948. </table>
  949. </td>
  950. <td class="mlabels-right">
  951. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  952. </tr>
  953. </table>
  954. </div><div class="memdoc">
  955. <p>Get a string from a file.</p>
  956. <p><a class="el" href="class_fat_file.html#a31ef26b3ee37cf5f5f4c6024c0ddab69">fgets()</a> reads bytes from a file into the array pointed to by <em>str</em>, until <em>num</em> - 1 bytes are read, or a delimiter is read and transferred to <em>str</em>, or end-of-file is encountered. The string is then terminated with a null byte.</p>
  957. <p><a class="el" href="class_fat_file.html#a31ef26b3ee37cf5f5f4c6024c0ddab69">fgets()</a> deletes CR, '\r', from the string. This insures only a '\n' terminates the string for Windows text files which use CRLF for newline.</p>
  958. <dl class="params"><dt>Parameters</dt><dd>
  959. <table class="params">
  960. <tr><td class="paramdir">[out]</td><td class="paramname">str</td><td>Pointer to the array where the string is stored. </td></tr>
  961. <tr><td class="paramdir">[in]</td><td class="paramname">num</td><td>Maximum number of characters to be read (including the final null byte). Usually the length of the array <em>str</em> is used. </td></tr>
  962. <tr><td class="paramdir">[in]</td><td class="paramname">delim</td><td>Optional set of delimiters. The default is "\n".</td></tr>
  963. </table>
  964. </dd>
  965. </dl>
  966. <dl class="section return"><dt>Returns</dt><dd>For success <a class="el" href="class_fat_file.html#a31ef26b3ee37cf5f5f4c6024c0ddab69">fgets()</a> returns the length of the string in <em>str</em>. If no data is read, <a class="el" href="class_fat_file.html#a31ef26b3ee37cf5f5f4c6024c0ddab69">fgets()</a> returns zero for EOF or -1 if an error occurred. </dd></dl>
  967. </div>
  968. </div>
  969. <a class="anchor" id="a7e043dfb89d268bfd620bbbadacf1002"></a>
  970. <div class="memitem">
  971. <div class="memproto">
  972. <table class="mlabels">
  973. <tr>
  974. <td class="mlabels-left">
  975. <table class="memname">
  976. <tr>
  977. <td class="memname">uint8_t FatFile::fileAttr </td>
  978. <td>(</td>
  979. <td class="paramname"></td><td>)</td>
  980. <td> const</td>
  981. </tr>
  982. </table>
  983. </td>
  984. <td class="mlabels-right">
  985. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  986. </tr>
  987. </table>
  988. </div><div class="memdoc">
  989. <p>Type of file. You should use <a class="el" href="class_fat_file.html#afcf6270ea8d4a3a5f8e89523bc684e22">isFile()</a> or <a class="el" href="class_fat_file.html#aef41d65e0f1ce753d18cc9ed691f7de4">isDir()</a> instead of fileType() if possible.</p>
  990. <dl class="section return"><dt>Returns</dt><dd>The file or directory type. </dd></dl>
  991. </div>
  992. </div>
  993. <a class="anchor" id="a02fc3b3ca36b4745f695f3de8c8ec36d"></a>
  994. <div class="memitem">
  995. <div class="memproto">
  996. <table class="mlabels">
  997. <tr>
  998. <td class="mlabels-left">
  999. <table class="memname">
  1000. <tr>
  1001. <td class="memname">uint32_t FatFile::fileSize </td>
  1002. <td>(</td>
  1003. <td class="paramname"></td><td>)</td>
  1004. <td> const</td>
  1005. </tr>
  1006. </table>
  1007. </td>
  1008. <td class="mlabels-right">
  1009. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1010. </tr>
  1011. </table>
  1012. </div><div class="memdoc">
  1013. <dl class="section return"><dt>Returns</dt><dd>The total number of bytes in a file. </dd></dl>
  1014. </div>
  1015. </div>
  1016. <a class="anchor" id="ac87b753811e540c7b799da56fa89724b"></a>
  1017. <div class="memitem">
  1018. <div class="memproto">
  1019. <table class="mlabels">
  1020. <tr>
  1021. <td class="mlabels-left">
  1022. <table class="memname">
  1023. <tr>
  1024. <td class="memname">uint32_t FatFile::firstBlock </td>
  1025. <td>(</td>
  1026. <td class="paramname"></td><td>)</td>
  1027. <td></td>
  1028. </tr>
  1029. </table>
  1030. </td>
  1031. <td class="mlabels-right">
  1032. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1033. </tr>
  1034. </table>
  1035. </div><div class="memdoc">
  1036. <dl class="section return"><dt>Returns</dt><dd>first block of file or zero for empty file. </dd></dl>
  1037. </div>
  1038. </div>
  1039. <a class="anchor" id="a1057bc23b92a074539f661e896e79a09"></a>
  1040. <div class="memitem">
  1041. <div class="memproto">
  1042. <table class="mlabels">
  1043. <tr>
  1044. <td class="mlabels-left">
  1045. <table class="memname">
  1046. <tr>
  1047. <td class="memname">uint32_t FatFile::firstCluster </td>
  1048. <td>(</td>
  1049. <td class="paramname"></td><td>)</td>
  1050. <td> const</td>
  1051. </tr>
  1052. </table>
  1053. </td>
  1054. <td class="mlabels-right">
  1055. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1056. </tr>
  1057. </table>
  1058. </div><div class="memdoc">
  1059. <dl class="section return"><dt>Returns</dt><dd>The first cluster number for a file or directory. </dd></dl>
  1060. </div>
  1061. </div>
  1062. <a class="anchor" id="af87fa862de707575b8badd044a5af80e"></a>
  1063. <div class="memitem">
  1064. <div class="memproto">
  1065. <table class="mlabels">
  1066. <tr>
  1067. <td class="mlabels-left">
  1068. <table class="memname">
  1069. <tr>
  1070. <td class="memname">void File::flush </td>
  1071. <td>(</td>
  1072. <td class="paramname"></td><td>)</td>
  1073. <td></td>
  1074. </tr>
  1075. </table>
  1076. </td>
  1077. <td class="mlabels-right">
  1078. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1079. </tr>
  1080. </table>
  1081. </div><div class="memdoc">
  1082. <p>Ensure that any bytes written to the file are saved to the SD card. </p>
  1083. </div>
  1084. </div>
  1085. <a class="anchor" id="ad0dbbd083180f44c7a3ce7124d4ce19c"></a>
  1086. <div class="memitem">
  1087. <div class="memproto">
  1088. <table class="mlabels">
  1089. <tr>
  1090. <td class="mlabels-left">
  1091. <table class="memname">
  1092. <tr>
  1093. <td class="memname">uint8_t FatFile::getError </td>
  1094. <td>(</td>
  1095. <td class="paramname"></td><td>)</td>
  1096. <td></td>
  1097. </tr>
  1098. </table>
  1099. </td>
  1100. <td class="mlabels-right">
  1101. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1102. </tr>
  1103. </table>
  1104. </div><div class="memdoc">
  1105. <dl class="section return"><dt>Returns</dt><dd>All error bits. </dd></dl>
  1106. </div>
  1107. </div>
  1108. <a class="anchor" id="aafa565e286440aab612cdb430fc01da5"></a>
  1109. <div class="memitem">
  1110. <div class="memproto">
  1111. <table class="mlabels">
  1112. <tr>
  1113. <td class="mlabels-left">
  1114. <table class="memname">
  1115. <tr>
  1116. <td class="memname">bool FatFile::getName </td>
  1117. <td>(</td>
  1118. <td class="paramtype">char *&#160;</td>
  1119. <td class="paramname"><em>name</em>, </td>
  1120. </tr>
  1121. <tr>
  1122. <td class="paramkey"></td>
  1123. <td></td>
  1124. <td class="paramtype">size_t&#160;</td>
  1125. <td class="paramname"><em>size</em>&#160;</td>
  1126. </tr>
  1127. <tr>
  1128. <td></td>
  1129. <td>)</td>
  1130. <td></td><td></td>
  1131. </tr>
  1132. </table>
  1133. </td>
  1134. <td class="mlabels-right">
  1135. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1136. </tr>
  1137. </table>
  1138. </div><div class="memdoc">
  1139. <p>Get a file's name followed by a zero byte.</p>
  1140. <dl class="params"><dt>Parameters</dt><dd>
  1141. <table class="params">
  1142. <tr><td class="paramdir">[out]</td><td class="paramname">name</td><td>An array of characters for the file's name. </td></tr>
  1143. <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The size of the array in bytes. The array must be at least 13 bytes long. The file's name will be truncated if the file's name is too long. </td></tr>
  1144. </table>
  1145. </dd>
  1146. </dl>
  1147. <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>
  1148. </div>
  1149. </div>
  1150. <a class="anchor" id="aaa4f9886887947815a61eaf015996932"></a>
  1151. <div class="memitem">
  1152. <div class="memproto">
  1153. <table class="mlabels">
  1154. <tr>
  1155. <td class="mlabels-left">
  1156. <table class="memname">
  1157. <tr>
  1158. <td class="memname">void FatFile::getpos </td>
  1159. <td>(</td>
  1160. <td class="paramtype"><a class="el" href="struct_fat_pos__t.html">FatPos_t</a> *&#160;</td>
  1161. <td class="paramname"><em>pos</em></td><td>)</td>
  1162. <td></td>
  1163. </tr>
  1164. </table>
  1165. </td>
  1166. <td class="mlabels-right">
  1167. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1168. </tr>
  1169. </table>
  1170. </div><div class="memdoc">
  1171. <p>get position for streams </p><dl class="params"><dt>Parameters</dt><dd>
  1172. <table class="params">
  1173. <tr><td class="paramdir">[out]</td><td class="paramname">pos</td><td>struct to receive position </td></tr>
  1174. </table>
  1175. </dd>
  1176. </dl>
  1177. </div>
  1178. </div>
  1179. <a class="anchor" id="aba30e92a66f8e0d2f815c85662772a58"></a>
  1180. <div class="memitem">
  1181. <div class="memproto">
  1182. <table class="mlabels">
  1183. <tr>
  1184. <td class="mlabels-left">
  1185. <table class="memname">
  1186. <tr>
  1187. <td class="memname">bool FatFile::getSFN </td>
  1188. <td>(</td>
  1189. <td class="paramtype">char *&#160;</td>
  1190. <td class="paramname"><em>name</em></td><td>)</td>
  1191. <td></td>
  1192. </tr>
  1193. </table>
  1194. </td>
  1195. <td class="mlabels-right">
  1196. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1197. </tr>
  1198. </table>
  1199. </div><div class="memdoc">
  1200. <p>Get a file's Short <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> Name followed by a zero byte.</p>
  1201. <dl class="params"><dt>Parameters</dt><dd>
  1202. <table class="params">
  1203. <tr><td class="paramdir">[out]</td><td class="paramname">name</td><td>An array of characters for the file's name. The array must be at least 13 bytes long. </td></tr>
  1204. </table>
  1205. </dd>
  1206. </dl>
  1207. <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>
  1208. </div>
  1209. </div>
  1210. <a class="anchor" id="a8062c0d3a118e8d77d0310418703d5f5"></a>
  1211. <div class="memitem">
  1212. <div class="memproto">
  1213. <table class="mlabels">
  1214. <tr>
  1215. <td class="mlabels-left">
  1216. <table class="memname">
  1217. <tr>
  1218. <td class="memname">bool FatFile::getWriteError </td>
  1219. <td>(</td>
  1220. <td class="paramname"></td><td>)</td>
  1221. <td></td>
  1222. </tr>
  1223. </table>
  1224. </td>
  1225. <td class="mlabels-right">
  1226. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1227. </tr>
  1228. </table>
  1229. </div><div class="memdoc">
  1230. <dl class="section return"><dt>Returns</dt><dd>value of writeError </dd></dl>
  1231. </div>
  1232. </div>
  1233. <a class="anchor" id="aef41d65e0f1ce753d18cc9ed691f7de4"></a>
  1234. <div class="memitem">
  1235. <div class="memproto">
  1236. <table class="mlabels">
  1237. <tr>
  1238. <td class="mlabels-left">
  1239. <table class="memname">
  1240. <tr>
  1241. <td class="memname">bool FatFile::isDir </td>
  1242. <td>(</td>
  1243. <td class="paramname"></td><td>)</td>
  1244. <td> const</td>
  1245. </tr>
  1246. </table>
  1247. </td>
  1248. <td class="mlabels-right">
  1249. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1250. </tr>
  1251. </table>
  1252. </div><div class="memdoc">
  1253. <dl class="section return"><dt>Returns</dt><dd>True if this is a directory else false. </dd></dl>
  1254. </div>
  1255. </div>
  1256. <a class="anchor" id="a6ba5bdb943363cda56649238ccb18c27"></a>
  1257. <div class="memitem">
  1258. <div class="memproto">
  1259. <table class="mlabels">
  1260. <tr>
  1261. <td class="mlabels-left">
  1262. <table class="memname">
  1263. <tr>
  1264. <td class="memname">bool File::isDirectory </td>
  1265. <td>(</td>
  1266. <td class="paramname"></td><td>)</td>
  1267. <td></td>
  1268. </tr>
  1269. </table>
  1270. </td>
  1271. <td class="mlabels-right">
  1272. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1273. </tr>
  1274. </table>
  1275. </div><div class="memdoc">
  1276. <p>This function reports if the current file is a directory or not. </p><dl class="section return"><dt>Returns</dt><dd>true if the file is a directory. </dd></dl>
  1277. </div>
  1278. </div>
  1279. <a class="anchor" id="afcf6270ea8d4a3a5f8e89523bc684e22"></a>
  1280. <div class="memitem">
  1281. <div class="memproto">
  1282. <table class="mlabels">
  1283. <tr>
  1284. <td class="mlabels-left">
  1285. <table class="memname">
  1286. <tr>
  1287. <td class="memname">bool FatFile::isFile </td>
  1288. <td>(</td>
  1289. <td class="paramname"></td><td>)</td>
  1290. <td> const</td>
  1291. </tr>
  1292. </table>
  1293. </td>
  1294. <td class="mlabels-right">
  1295. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1296. </tr>
  1297. </table>
  1298. </div><div class="memdoc">
  1299. <dl class="section return"><dt>Returns</dt><dd>True if this is a normal file else false. </dd></dl>
  1300. </div>
  1301. </div>
  1302. <a class="anchor" id="a7eefe7408f34b6326f0c6e78af7eb05f"></a>
  1303. <div class="memitem">
  1304. <div class="memproto">
  1305. <table class="mlabels">
  1306. <tr>
  1307. <td class="mlabels-left">
  1308. <table class="memname">
  1309. <tr>
  1310. <td class="memname">bool FatFile::isHidden </td>
  1311. <td>(</td>
  1312. <td class="paramname"></td><td>)</td>
  1313. <td> const</td>
  1314. </tr>
  1315. </table>
  1316. </td>
  1317. <td class="mlabels-right">
  1318. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1319. </tr>
  1320. </table>
  1321. </div><div class="memdoc">
  1322. <dl class="section return"><dt>Returns</dt><dd>True if this is a hidden file else false. </dd></dl>
  1323. </div>
  1324. </div>
  1325. <a class="anchor" id="aed36d17f8fde597b6ed9446faec1f7e3"></a>
  1326. <div class="memitem">
  1327. <div class="memproto">
  1328. <table class="mlabels">
  1329. <tr>
  1330. <td class="mlabels-left">
  1331. <table class="memname">
  1332. <tr>
  1333. <td class="memname">bool FatFile::isLFN </td>
  1334. <td>(</td>
  1335. <td class="paramname"></td><td>)</td>
  1336. <td> const</td>
  1337. </tr>
  1338. </table>
  1339. </td>
  1340. <td class="mlabels-right">
  1341. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1342. </tr>
  1343. </table>
  1344. </div><div class="memdoc">
  1345. <dl class="section return"><dt>Returns</dt><dd>true if this file has a Long <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> Name. </dd></dl>
  1346. </div>
  1347. </div>
  1348. <a class="anchor" id="a4c8a07b081f04aa25839c6f56c739bdc"></a>
  1349. <div class="memitem">
  1350. <div class="memproto">
  1351. <table class="mlabels">
  1352. <tr>
  1353. <td class="mlabels-left">
  1354. <table class="memname">
  1355. <tr>
  1356. <td class="memname">bool FatFile::isOpen </td>
  1357. <td>(</td>
  1358. <td class="paramname"></td><td>)</td>
  1359. <td> const</td>
  1360. </tr>
  1361. </table>
  1362. </td>
  1363. <td class="mlabels-right">
  1364. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1365. </tr>
  1366. </table>
  1367. </div><div class="memdoc">
  1368. <dl class="section return"><dt>Returns</dt><dd>True if this is an open file/directory else false. </dd></dl>
  1369. </div>
  1370. </div>
  1371. <a class="anchor" id="a6872d3acb1e70f81c9c2be2495977583"></a>
  1372. <div class="memitem">
  1373. <div class="memproto">
  1374. <table class="mlabels">
  1375. <tr>
  1376. <td class="mlabels-left">
  1377. <table class="memname">
  1378. <tr>
  1379. <td class="memname">bool FatFile::isReadOnly </td>
  1380. <td>(</td>
  1381. <td class="paramname"></td><td>)</td>
  1382. <td> const</td>
  1383. </tr>
  1384. </table>
  1385. </td>
  1386. <td class="mlabels-right">
  1387. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1388. </tr>
  1389. </table>
  1390. </div><div class="memdoc">
  1391. <dl class="section return"><dt>Returns</dt><dd>True if file is read-only </dd></dl>
  1392. </div>
  1393. </div>
  1394. <a class="anchor" id="aa4a206803a4bf8243be20244c1aef4d2"></a>
  1395. <div class="memitem">
  1396. <div class="memproto">
  1397. <table class="mlabels">
  1398. <tr>
  1399. <td class="mlabels-left">
  1400. <table class="memname">
  1401. <tr>
  1402. <td class="memname">bool FatFile::isRoot </td>
  1403. <td>(</td>
  1404. <td class="paramname"></td><td>)</td>
  1405. <td> const</td>
  1406. </tr>
  1407. </table>
  1408. </td>
  1409. <td class="mlabels-right">
  1410. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1411. </tr>
  1412. </table>
  1413. </div><div class="memdoc">
  1414. <dl class="section return"><dt>Returns</dt><dd>True if this is the root directory. </dd></dl>
  1415. </div>
  1416. </div>
  1417. <a class="anchor" id="a1449b294e3a838396c62e47674ca8cf0"></a>
  1418. <div class="memitem">
  1419. <div class="memproto">
  1420. <table class="mlabels">
  1421. <tr>
  1422. <td class="mlabels-left">
  1423. <table class="memname">
  1424. <tr>
  1425. <td class="memname">bool FatFile::isRoot32 </td>
  1426. <td>(</td>
  1427. <td class="paramname"></td><td>)</td>
  1428. <td> const</td>
  1429. </tr>
  1430. </table>
  1431. </td>
  1432. <td class="mlabels-right">
  1433. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1434. </tr>
  1435. </table>
  1436. </div><div class="memdoc">
  1437. <dl class="section return"><dt>Returns</dt><dd>True if this is the FAT32 root directory. </dd></dl>
  1438. </div>
  1439. </div>
  1440. <a class="anchor" id="a8215bd4b21e11ec83fa88ef226ceb06f"></a>
  1441. <div class="memitem">
  1442. <div class="memproto">
  1443. <table class="mlabels">
  1444. <tr>
  1445. <td class="mlabels-left">
  1446. <table class="memname">
  1447. <tr>
  1448. <td class="memname">bool FatFile::isRootFixed </td>
  1449. <td>(</td>
  1450. <td class="paramname"></td><td>)</td>
  1451. <td> const</td>
  1452. </tr>
  1453. </table>
  1454. </td>
  1455. <td class="mlabels-right">
  1456. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1457. </tr>
  1458. </table>
  1459. </div><div class="memdoc">
  1460. <dl class="section return"><dt>Returns</dt><dd>True if this is the FAT12 of FAT16 root directory. </dd></dl>
  1461. </div>
  1462. </div>
  1463. <a class="anchor" id="a95b503b17442c2b364a2f53de1b2aeba"></a>
  1464. <div class="memitem">
  1465. <div class="memproto">
  1466. <table class="mlabels">
  1467. <tr>
  1468. <td class="mlabels-left">
  1469. <table class="memname">
  1470. <tr>
  1471. <td class="memname">bool FatFile::isSubDir </td>
  1472. <td>(</td>
  1473. <td class="paramname"></td><td>)</td>
  1474. <td> const</td>
  1475. </tr>
  1476. </table>
  1477. </td>
  1478. <td class="mlabels-right">
  1479. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1480. </tr>
  1481. </table>
  1482. </div><div class="memdoc">
  1483. <dl class="section return"><dt>Returns</dt><dd>True if this is a subdirectory else false. </dd></dl>
  1484. </div>
  1485. </div>
  1486. <a class="anchor" id="add932e13e5bf32ad467af6ec34824e3c"></a>
  1487. <div class="memitem">
  1488. <div class="memproto">
  1489. <table class="mlabels">
  1490. <tr>
  1491. <td class="mlabels-left">
  1492. <table class="memname">
  1493. <tr>
  1494. <td class="memname">bool FatFile::isSystem </td>
  1495. <td>(</td>
  1496. <td class="paramname"></td><td>)</td>
  1497. <td> const</td>
  1498. </tr>
  1499. </table>
  1500. </td>
  1501. <td class="mlabels-right">
  1502. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1503. </tr>
  1504. </table>
  1505. </div><div class="memdoc">
  1506. <dl class="section return"><dt>Returns</dt><dd>True if this is a system file else false. </dd></dl>
  1507. </div>
  1508. </div>
  1509. <a class="anchor" id="a94df8090f16e9666cdc53ca20f6aff90"></a>
  1510. <div class="memitem">
  1511. <div class="memproto">
  1512. <table class="mlabels">
  1513. <tr>
  1514. <td class="mlabels-left">
  1515. <table class="memname">
  1516. <tr>
  1517. <td class="memname">static bool FatFile::legal83Char </td>
  1518. <td>(</td>
  1519. <td class="paramtype">uint8_t&#160;</td>
  1520. <td class="paramname"><em>c</em></td><td>)</td>
  1521. <td></td>
  1522. </tr>
  1523. </table>
  1524. </td>
  1525. <td class="mlabels-right">
  1526. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  1527. </tr>
  1528. </table>
  1529. </div><div class="memdoc">
  1530. <p>Check for a legal 8.3 character. </p><dl class="params"><dt>Parameters</dt><dd>
  1531. <table class="params">
  1532. <tr><td class="paramdir">[in]</td><td class="paramname">c</td><td>Character to be checked. </td></tr>
  1533. </table>
  1534. </dd>
  1535. </dl>
  1536. <dl class="section return"><dt>Returns</dt><dd>true for a legal 8.3 character else false. </dd></dl>
  1537. </div>
  1538. </div>
  1539. <a class="anchor" id="ad49f688a494b351ccbb0102dcfafb925"></a>
  1540. <div class="memitem">
  1541. <div class="memproto">
  1542. <table class="mlabels">
  1543. <tr>
  1544. <td class="mlabels-left">
  1545. <table class="memname">
  1546. <tr>
  1547. <td class="memname">void FatFile::ls </td>
  1548. <td>(</td>
  1549. <td class="paramtype">uint8_t&#160;</td>
  1550. <td class="paramname"><em>flags</em> = <code>0</code></td><td>)</td>
  1551. <td></td>
  1552. </tr>
  1553. </table>
  1554. </td>
  1555. <td class="mlabels-right">
  1556. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1557. </tr>
  1558. </table>
  1559. </div><div class="memdoc">
  1560. <p>List directory contents.</p>
  1561. <dl class="params"><dt>Parameters</dt><dd>
  1562. <table class="params">
  1563. <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>The inclusive OR of</td></tr>
  1564. </table>
  1565. </dd>
  1566. </dl>
  1567. <p>LS_DATE - Print file modification date</p>
  1568. <p>LS_SIZE - Print file size.</p>
  1569. <p>LS_R - Recursive list of subdirectories. </p>
  1570. </div>
  1571. </div>
  1572. <a class="anchor" id="acabf31ff85e696fbf384c49428012fea"></a>
  1573. <div class="memitem">
  1574. <div class="memproto">
  1575. <table class="mlabels">
  1576. <tr>
  1577. <td class="mlabels-left">
  1578. <table class="memname">
  1579. <tr>
  1580. <td class="memname">void FatFile::ls </td>
  1581. <td>(</td>
  1582. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  1583. <td class="paramname"><em>pr</em>, </td>
  1584. </tr>
  1585. <tr>
  1586. <td class="paramkey"></td>
  1587. <td></td>
  1588. <td class="paramtype">uint8_t&#160;</td>
  1589. <td class="paramname"><em>flags</em> = <code>0</code>, </td>
  1590. </tr>
  1591. <tr>
  1592. <td class="paramkey"></td>
  1593. <td></td>
  1594. <td class="paramtype">uint8_t&#160;</td>
  1595. <td class="paramname"><em>indent</em> = <code>0</code>&#160;</td>
  1596. </tr>
  1597. <tr>
  1598. <td></td>
  1599. <td>)</td>
  1600. <td></td><td></td>
  1601. </tr>
  1602. </table>
  1603. </td>
  1604. <td class="mlabels-right">
  1605. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1606. </tr>
  1607. </table>
  1608. </div><div class="memdoc">
  1609. <p>List directory contents.</p>
  1610. <dl class="params"><dt>Parameters</dt><dd>
  1611. <table class="params">
  1612. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for list.</td></tr>
  1613. <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>The inclusive OR of</td></tr>
  1614. </table>
  1615. </dd>
  1616. </dl>
  1617. <p>LS_DATE - Print file modification date</p>
  1618. <p>LS_SIZE - Print file size.</p>
  1619. <p>LS_R - Recursive list of subdirectories.</p>
  1620. <dl class="params"><dt>Parameters</dt><dd>
  1621. <table class="params">
  1622. <tr><td class="paramdir">[in]</td><td class="paramname">indent</td><td>Amount of space before file name. Used for recursive list to indicate subdirectory level. </td></tr>
  1623. </table>
  1624. </dd>
  1625. </dl>
  1626. </div>
  1627. </div>
  1628. <a class="anchor" id="abab5b9f72cc796388dd4eed01d13d90d"></a>
  1629. <div class="memitem">
  1630. <div class="memproto">
  1631. <table class="mlabels">
  1632. <tr>
  1633. <td class="mlabels-left">
  1634. <table class="memname">
  1635. <tr>
  1636. <td class="memname">bool FatFile::mkdir </td>
  1637. <td>(</td>
  1638. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  1639. <td class="paramname"><em>dir</em>, </td>
  1640. </tr>
  1641. <tr>
  1642. <td class="paramkey"></td>
  1643. <td></td>
  1644. <td class="paramtype">const char *&#160;</td>
  1645. <td class="paramname"><em>path</em>, </td>
  1646. </tr>
  1647. <tr>
  1648. <td class="paramkey"></td>
  1649. <td></td>
  1650. <td class="paramtype">bool&#160;</td>
  1651. <td class="paramname"><em>pFlag</em> = <code>true</code>&#160;</td>
  1652. </tr>
  1653. <tr>
  1654. <td></td>
  1655. <td>)</td>
  1656. <td></td><td></td>
  1657. </tr>
  1658. </table>
  1659. </td>
  1660. <td class="mlabels-right">
  1661. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1662. </tr>
  1663. </table>
  1664. </div><div class="memdoc">
  1665. <p>Make a new directory.</p>
  1666. <dl class="params"><dt>Parameters</dt><dd>
  1667. <table class="params">
  1668. <tr><td class="paramdir">[in]</td><td class="paramname">dir</td><td>An open <a class="el" href="class_fat_file.html" title="Basic file class. ">FatFile</a> instance for the directory that will contain the new directory.</td></tr>
  1669. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid 8.3 DOS name for the new directory.</td></tr>
  1670. <tr><td class="paramdir">[in]</td><td class="paramname">pFlag</td><td>Create missing parent directories if true.</td></tr>
  1671. </table>
  1672. </dd>
  1673. </dl>
  1674. <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>
  1675. </div>
  1676. </div>
  1677. <a class="anchor" id="a7ca23d8d3997c10c221977c64736f575"></a>
  1678. <div class="memitem">
  1679. <div class="memproto">
  1680. <table class="mlabels">
  1681. <tr>
  1682. <td class="mlabels-left">
  1683. <table class="memname">
  1684. <tr>
  1685. <td class="memname">const char* File::name </td>
  1686. <td>(</td>
  1687. <td class="paramname"></td><td>)</td>
  1688. <td> const</td>
  1689. </tr>
  1690. </table>
  1691. </td>
  1692. <td class="mlabels-right">
  1693. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1694. </tr>
  1695. </table>
  1696. </div><div class="memdoc">
  1697. <p>No longer implemented due to Long <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> Names.</p>
  1698. <p>Use <a class="el" href="class_fat_file.html#aafa565e286440aab612cdb430fc01da5">getName(char* name, size_t size)</a>. </p><dl class="section return"><dt>Returns</dt><dd>a pointer to replacement suggestion. </dd></dl>
  1699. </div>
  1700. </div>
  1701. <a class="anchor" id="a5f64576d3d19177ab3cf3812b69abdfa"></a>
  1702. <div class="memitem">
  1703. <div class="memproto">
  1704. <table class="mlabels">
  1705. <tr>
  1706. <td class="mlabels-left">
  1707. <table class="memname">
  1708. <tr>
  1709. <td class="memname">bool FatFile::open </td>
  1710. <td>(</td>
  1711. <td class="paramtype"><a class="el" href="class_fat_file_system.html">FatFileSystem</a> *&#160;</td>
  1712. <td class="paramname"><em>fs</em>, </td>
  1713. </tr>
  1714. <tr>
  1715. <td class="paramkey"></td>
  1716. <td></td>
  1717. <td class="paramtype">const char *&#160;</td>
  1718. <td class="paramname"><em>path</em>, </td>
  1719. </tr>
  1720. <tr>
  1721. <td class="paramkey"></td>
  1722. <td></td>
  1723. <td class="paramtype">uint8_t&#160;</td>
  1724. <td class="paramname"><em>oflag</em>&#160;</td>
  1725. </tr>
  1726. <tr>
  1727. <td></td>
  1728. <td>)</td>
  1729. <td></td><td></td>
  1730. </tr>
  1731. </table>
  1732. </td>
  1733. <td class="mlabels-right">
  1734. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1735. </tr>
  1736. </table>
  1737. </div><div class="memdoc">
  1738. <p>Open a file in the volume working directory of a <a class="el" href="class_fat_file_system.html" title="Integration class for the FatLib library. ">FatFileSystem</a>.</p>
  1739. <dl class="params"><dt>Parameters</dt><dd>
  1740. <table class="params">
  1741. <tr><td class="paramdir">[in]</td><td class="paramname">fs</td><td><a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> System where the file is located.</td></tr>
  1742. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>with a valid 8.3 DOS name for a file to be opened.</td></tr>
  1743. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>bitwise-inclusive OR of open mode flags. See see <a class="el" href="class_fat_file.html#a211be757679b18708f6b6a36464e4f61">FatFile::open(FatFile*, const char*, uint8_t)</a>.</td></tr>
  1744. </table>
  1745. </dd>
  1746. </dl>
  1747. <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>
  1748. </div>
  1749. </div>
  1750. <a class="anchor" id="ad3fa9daaccb4e4179fb88a8ca037aa80"></a>
  1751. <div class="memitem">
  1752. <div class="memproto">
  1753. <table class="mlabels">
  1754. <tr>
  1755. <td class="mlabels-left">
  1756. <table class="memname">
  1757. <tr>
  1758. <td class="memname">bool FatFile::open </td>
  1759. <td>(</td>
  1760. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  1761. <td class="paramname"><em>dirFile</em>, </td>
  1762. </tr>
  1763. <tr>
  1764. <td class="paramkey"></td>
  1765. <td></td>
  1766. <td class="paramtype">uint16_t&#160;</td>
  1767. <td class="paramname"><em>index</em>, </td>
  1768. </tr>
  1769. <tr>
  1770. <td class="paramkey"></td>
  1771. <td></td>
  1772. <td class="paramtype">uint8_t&#160;</td>
  1773. <td class="paramname"><em>oflag</em>&#160;</td>
  1774. </tr>
  1775. <tr>
  1776. <td></td>
  1777. <td>)</td>
  1778. <td></td><td></td>
  1779. </tr>
  1780. </table>
  1781. </td>
  1782. <td class="mlabels-right">
  1783. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1784. </tr>
  1785. </table>
  1786. </div><div class="memdoc">
  1787. <p>Open a file by index.</p>
  1788. <dl class="params"><dt>Parameters</dt><dd>
  1789. <table class="params">
  1790. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>An open <a class="el" href="class_fat_file.html" title="Basic file class. ">FatFile</a> instance for the directory.</td></tr>
  1791. <tr><td class="paramdir">[in]</td><td class="paramname">index</td><td>The <em>index</em> of the directory entry for the file to be opened. The value for <em>index</em> is (directory file position)/32.</td></tr>
  1792. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>bitwise-inclusive OR of open mode flags. See see <a class="el" href="class_fat_file.html#a211be757679b18708f6b6a36464e4f61">FatFile::open(FatFile*, const char*, uint8_t)</a>.</td></tr>
  1793. </table>
  1794. </dd>
  1795. </dl>
  1796. <p>See <a class="el" href="class_fat_file.html#a5f64576d3d19177ab3cf3812b69abdfa">open()</a> by path for definition of flags. </p><dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1797. </div>
  1798. </div>
  1799. <a class="anchor" id="a211be757679b18708f6b6a36464e4f61"></a>
  1800. <div class="memitem">
  1801. <div class="memproto">
  1802. <table class="mlabels">
  1803. <tr>
  1804. <td class="mlabels-left">
  1805. <table class="memname">
  1806. <tr>
  1807. <td class="memname">bool FatFile::open </td>
  1808. <td>(</td>
  1809. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  1810. <td class="paramname"><em>dirFile</em>, </td>
  1811. </tr>
  1812. <tr>
  1813. <td class="paramkey"></td>
  1814. <td></td>
  1815. <td class="paramtype">const char *&#160;</td>
  1816. <td class="paramname"><em>path</em>, </td>
  1817. </tr>
  1818. <tr>
  1819. <td class="paramkey"></td>
  1820. <td></td>
  1821. <td class="paramtype">uint8_t&#160;</td>
  1822. <td class="paramname"><em>oflag</em>&#160;</td>
  1823. </tr>
  1824. <tr>
  1825. <td></td>
  1826. <td>)</td>
  1827. <td></td><td></td>
  1828. </tr>
  1829. </table>
  1830. </td>
  1831. <td class="mlabels-right">
  1832. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1833. </tr>
  1834. </table>
  1835. </div><div class="memdoc">
  1836. <p>Open a file or directory by name.</p>
  1837. <dl class="params"><dt>Parameters</dt><dd>
  1838. <table class="params">
  1839. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>An open <a class="el" href="class_fat_file.html" title="Basic file class. ">FatFile</a> instance for the directory containing the file to be opened.</td></tr>
  1840. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid 8.3 DOS name for a file to be opened.</td></tr>
  1841. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>Values for <em>oflag</em> are constructed by a bitwise-inclusive OR of flags from the following list</td></tr>
  1842. </table>
  1843. </dd>
  1844. </dl>
  1845. <p>O_READ - Open for reading.</p>
  1846. <p>O_RDONLY - Same as O_READ.</p>
  1847. <p>O_WRITE - Open for writing.</p>
  1848. <p>O_WRONLY - Same as O_WRITE.</p>
  1849. <p>O_RDWR - Open for reading and writing.</p>
  1850. <p>O_APPEND - If set, the file offset shall be set to the end of the file prior to each write.</p>
  1851. <p>O_AT_END - Set the initial position at the end of the file.</p>
  1852. <p>O_CREAT - If the file exists, this flag has no effect except as noted under O_EXCL below. Otherwise, the file shall be created</p>
  1853. <p>O_EXCL - If O_CREAT and O_EXCL are set, <a class="el" href="class_fat_file.html#a5f64576d3d19177ab3cf3812b69abdfa">open()</a> shall fail if the file exists.</p>
  1854. <p>O_SYNC - Call <a class="el" href="class_fat_file.html#a67f3dc4896c542d695e11aac927f585e">sync()</a> after each write. This flag should not be used with <a class="el" href="class_fat_file.html#a5524bd9f3b8f54ee163e391cba618186">write(uint8_t)</a> or any functions do character at a time writes since <a class="el" href="class_fat_file.html#a67f3dc4896c542d695e11aac927f585e">sync()</a> will be called after each byte.</p>
  1855. <p>O_TRUNC - If the file exists and is a regular file, and the file is successfully opened and is not read only, its length shall be truncated to 0.</p>
  1856. <p>WARNING: A given file must not be opened by more than one <a class="el" href="class_fat_file.html" title="Basic file class. ">FatFile</a> object or file corruption may occur.</p>
  1857. <dl class="section note"><dt>Note</dt><dd>Directory files must be opened read only. Write and truncation is not allowed for directory files.</dd></dl>
  1858. <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>
  1859. </div>
  1860. </div>
  1861. <a class="anchor" id="ab0e7075062c89f356441f80fc64d03e6"></a>
  1862. <div class="memitem">
  1863. <div class="memproto">
  1864. <table class="mlabels">
  1865. <tr>
  1866. <td class="mlabels-left">
  1867. <table class="memname">
  1868. <tr>
  1869. <td class="memname">bool FatFile::open </td>
  1870. <td>(</td>
  1871. <td class="paramtype">const char *&#160;</td>
  1872. <td class="paramname"><em>path</em>, </td>
  1873. </tr>
  1874. <tr>
  1875. <td class="paramkey"></td>
  1876. <td></td>
  1877. <td class="paramtype">uint8_t&#160;</td>
  1878. <td class="paramname"><em>oflag</em> = <code>O_READ</code>&#160;</td>
  1879. </tr>
  1880. <tr>
  1881. <td></td>
  1882. <td>)</td>
  1883. <td></td><td></td>
  1884. </tr>
  1885. </table>
  1886. </td>
  1887. <td class="mlabels-right">
  1888. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  1889. </tr>
  1890. </table>
  1891. </div><div class="memdoc">
  1892. <p>Open a file in the current working directory.</p>
  1893. <dl class="params"><dt>Parameters</dt><dd>
  1894. <table class="params">
  1895. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid 8.3 DOS name for a file to be opened.</td></tr>
  1896. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>bitwise-inclusive OR of open mode flags. See see <a class="el" href="class_fat_file.html#a211be757679b18708f6b6a36464e4f61">FatFile::open(FatFile*, const char*, uint8_t)</a>.</td></tr>
  1897. </table>
  1898. </dd>
  1899. </dl>
  1900. <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>
  1901. </div>
  1902. </div>
  1903. <a class="anchor" id="a8034c4649eb0d26715b1a8a69e73d9d0"></a>
  1904. <div class="memitem">
  1905. <div class="memproto">
  1906. <table class="mlabels">
  1907. <tr>
  1908. <td class="mlabels-left">
  1909. <table class="memname">
  1910. <tr>
  1911. <td class="memname">bool FatFile::openNext </td>
  1912. <td>(</td>
  1913. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  1914. <td class="paramname"><em>dirFile</em>, </td>
  1915. </tr>
  1916. <tr>
  1917. <td class="paramkey"></td>
  1918. <td></td>
  1919. <td class="paramtype">uint8_t&#160;</td>
  1920. <td class="paramname"><em>oflag</em> = <code>O_READ</code>&#160;</td>
  1921. </tr>
  1922. <tr>
  1923. <td></td>
  1924. <td>)</td>
  1925. <td></td><td></td>
  1926. </tr>
  1927. </table>
  1928. </td>
  1929. <td class="mlabels-right">
  1930. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1931. </tr>
  1932. </table>
  1933. </div><div class="memdoc">
  1934. <p>Open the next file or subdirectory in a directory.</p>
  1935. <dl class="params"><dt>Parameters</dt><dd>
  1936. <table class="params">
  1937. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>An open <a class="el" href="class_fat_file.html" title="Basic file class. ">FatFile</a> instance for the directory containing the file to be opened.</td></tr>
  1938. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>bitwise-inclusive OR of open mode flags. See see <a class="el" href="class_fat_file.html#a211be757679b18708f6b6a36464e4f61">FatFile::open(FatFile*, const char*, uint8_t)</a>.</td></tr>
  1939. </table>
  1940. </dd>
  1941. </dl>
  1942. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1943. </div>
  1944. </div>
  1945. <a class="anchor" id="acd72000ab1f6a1ce73ac8fbdc854ae0c"></a>
  1946. <div class="memitem">
  1947. <div class="memproto">
  1948. <table class="mlabels">
  1949. <tr>
  1950. <td class="mlabels-left">
  1951. <table class="memname">
  1952. <tr>
  1953. <td class="memname"><a class="el" href="class_file.html">File</a> File::openNextFile </td>
  1954. <td>(</td>
  1955. <td class="paramtype">uint8_t&#160;</td>
  1956. <td class="paramname"><em>mode</em> = <code>O_READ</code></td><td>)</td>
  1957. <td></td>
  1958. </tr>
  1959. </table>
  1960. </td>
  1961. <td class="mlabels-right">
  1962. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1963. </tr>
  1964. </table>
  1965. </div><div class="memdoc">
  1966. <p>Opens the next file or folder in a directory.</p>
  1967. <dl class="params"><dt>Parameters</dt><dd>
  1968. <table class="params">
  1969. <tr><td class="paramdir">[in]</td><td class="paramname">mode</td><td>open mode flags. </td></tr>
  1970. </table>
  1971. </dd>
  1972. </dl>
  1973. <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>
  1974. </div>
  1975. </div>
  1976. <a class="anchor" id="a7e0c0548fed3a69e7284b91b694439d4"></a>
  1977. <div class="memitem">
  1978. <div class="memproto">
  1979. <table class="mlabels">
  1980. <tr>
  1981. <td class="mlabels-left">
  1982. <table class="memname">
  1983. <tr>
  1984. <td class="memname">bool FatFile::openRoot </td>
  1985. <td>(</td>
  1986. <td class="paramtype"><a class="el" href="class_fat_volume.html">FatVolume</a> *&#160;</td>
  1987. <td class="paramname"><em>vol</em></td><td>)</td>
  1988. <td></td>
  1989. </tr>
  1990. </table>
  1991. </td>
  1992. <td class="mlabels-right">
  1993. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  1994. </tr>
  1995. </table>
  1996. </div><div class="memdoc">
  1997. <p>Open a volume's root directory.</p>
  1998. <dl class="params"><dt>Parameters</dt><dd>
  1999. <table class="params">
  2000. <tr><td class="paramdir">[in]</td><td class="paramname">vol</td><td>The FAT volume containing the root directory to be opened.</td></tr>
  2001. </table>
  2002. </dd>
  2003. </dl>
  2004. <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>
  2005. </div>
  2006. </div>
  2007. <a class="anchor" id="af171fbf441c899cf71d88b8b0b83d38b"></a>
  2008. <div class="memitem">
  2009. <div class="memproto">
  2010. <table class="mlabels">
  2011. <tr>
  2012. <td class="mlabels-left">
  2013. <table class="memname">
  2014. <tr>
  2015. <td class="memname">File::operator bool </td>
  2016. <td>(</td>
  2017. <td class="paramname"></td><td>)</td>
  2018. <td></td>
  2019. </tr>
  2020. </table>
  2021. </td>
  2022. <td class="mlabels-right">
  2023. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2024. </tr>
  2025. </table>
  2026. </div><div class="memdoc">
  2027. <p>The parenthesis operator.</p>
  2028. <dl class="section return"><dt>Returns</dt><dd>true if a file is open. </dd></dl>
  2029. </div>
  2030. </div>
  2031. <a class="anchor" id="a0e5025f39bd584563bfe4b05fc1db268"></a>
  2032. <div class="memitem">
  2033. <div class="memproto">
  2034. <table class="mlabels">
  2035. <tr>
  2036. <td class="mlabels-left">
  2037. <table class="memname">
  2038. <tr>
  2039. <td class="memname">int File::peek </td>
  2040. <td>(</td>
  2041. <td class="paramname"></td><td>)</td>
  2042. <td></td>
  2043. </tr>
  2044. </table>
  2045. </td>
  2046. <td class="mlabels-right">
  2047. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2048. </tr>
  2049. </table>
  2050. </div><div class="memdoc">
  2051. <p>Return the next available byte without consuming it.</p>
  2052. <dl class="section return"><dt>Returns</dt><dd>The byte if no error and not at eof else -1; </dd></dl>
  2053. </div>
  2054. </div>
  2055. <a class="anchor" id="aae991c597c0bc4c5eb44c1f3b06a21ec"></a>
  2056. <div class="memitem">
  2057. <div class="memproto">
  2058. <table class="mlabels">
  2059. <tr>
  2060. <td class="mlabels-left">
  2061. <table class="memname">
  2062. <tr>
  2063. <td class="memname">uint32_t File::position </td>
  2064. <td>(</td>
  2065. <td class="paramname"></td><td>)</td>
  2066. <td></td>
  2067. </tr>
  2068. </table>
  2069. </td>
  2070. <td class="mlabels-right">
  2071. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2072. </tr>
  2073. </table>
  2074. </div><div class="memdoc">
  2075. <dl class="section return"><dt>Returns</dt><dd>the current file position. </dd></dl>
  2076. </div>
  2077. </div>
  2078. <a class="anchor" id="a558530f20314a8d8ee3d1a488fc7f46e"></a>
  2079. <div class="memitem">
  2080. <div class="memproto">
  2081. <table class="mlabels">
  2082. <tr>
  2083. <td class="mlabels-left">
  2084. <table class="memname">
  2085. <tr>
  2086. <td class="memname">bool FatFile::printCreateDateTime </td>
  2087. <td>(</td>
  2088. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  2089. <td class="paramname"><em>pr</em></td><td>)</td>
  2090. <td></td>
  2091. </tr>
  2092. </table>
  2093. </td>
  2094. <td class="mlabels-right">
  2095. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2096. </tr>
  2097. </table>
  2098. </div><div class="memdoc">
  2099. <p>Print a file's creation date and time</p>
  2100. <dl class="params"><dt>Parameters</dt><dd>
  2101. <table class="params">
  2102. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  2103. </table>
  2104. </dd>
  2105. </dl>
  2106. <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>
  2107. </div>
  2108. </div>
  2109. <a class="anchor" id="a8fdb038aafdf3a17ac80b53c063aa73b"></a>
  2110. <div class="memitem">
  2111. <div class="memproto">
  2112. <table class="mlabels">
  2113. <tr>
  2114. <td class="mlabels-left">
  2115. <table class="memname">
  2116. <tr>
  2117. <td class="memname">static void FatFile::printFatDate </td>
  2118. <td>(</td>
  2119. <td class="paramtype">uint16_t&#160;</td>
  2120. <td class="paramname"><em>fatDate</em></td><td>)</td>
  2121. <td></td>
  2122. </tr>
  2123. </table>
  2124. </td>
  2125. <td class="mlabels-right">
  2126. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  2127. </tr>
  2128. </table>
  2129. </div><div class="memdoc">
  2130. <p>Print a directory date field.</p>
  2131. <p>Format is yyyy-mm-dd.</p>
  2132. <dl class="params"><dt>Parameters</dt><dd>
  2133. <table class="params">
  2134. <tr><td class="paramdir">[in]</td><td class="paramname">fatDate</td><td>The date field from a directory entry. </td></tr>
  2135. </table>
  2136. </dd>
  2137. </dl>
  2138. </div>
  2139. </div>
  2140. <a class="anchor" id="ada5364f66204b1a64afbf9d2e6cd2b0b"></a>
  2141. <div class="memitem">
  2142. <div class="memproto">
  2143. <table class="mlabels">
  2144. <tr>
  2145. <td class="mlabels-left">
  2146. <table class="memname">
  2147. <tr>
  2148. <td class="memname">void FatFile::printFatDate </td>
  2149. <td>(</td>
  2150. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  2151. <td class="paramname"><em>pr</em>, </td>
  2152. </tr>
  2153. <tr>
  2154. <td class="paramkey"></td>
  2155. <td></td>
  2156. <td class="paramtype">uint16_t&#160;</td>
  2157. <td class="paramname"><em>fatDate</em>&#160;</td>
  2158. </tr>
  2159. <tr>
  2160. <td></td>
  2161. <td>)</td>
  2162. <td></td><td></td>
  2163. </tr>
  2164. </table>
  2165. </td>
  2166. <td class="mlabels-right">
  2167. <span class="mlabels"><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  2168. </tr>
  2169. </table>
  2170. </div><div class="memdoc">
  2171. <p>Print a directory date field.</p>
  2172. <p>Format is yyyy-mm-dd.</p>
  2173. <dl class="params"><dt>Parameters</dt><dd>
  2174. <table class="params">
  2175. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output. </td></tr>
  2176. <tr><td class="paramdir">[in]</td><td class="paramname">fatDate</td><td>The date field from a directory entry. </td></tr>
  2177. </table>
  2178. </dd>
  2179. </dl>
  2180. </div>
  2181. </div>
  2182. <a class="anchor" id="a7740731f08ef97de7dfbc9b075c4c7d1"></a>
  2183. <div class="memitem">
  2184. <div class="memproto">
  2185. <table class="mlabels">
  2186. <tr>
  2187. <td class="mlabels-left">
  2188. <table class="memname">
  2189. <tr>
  2190. <td class="memname">static void FatFile::printFatTime </td>
  2191. <td>(</td>
  2192. <td class="paramtype">uint16_t&#160;</td>
  2193. <td class="paramname"><em>fatTime</em></td><td>)</td>
  2194. <td></td>
  2195. </tr>
  2196. </table>
  2197. </td>
  2198. <td class="mlabels-right">
  2199. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  2200. </tr>
  2201. </table>
  2202. </div><div class="memdoc">
  2203. <p>Print a directory time field.</p>
  2204. <p>Format is hh:mm:ss.</p>
  2205. <dl class="params"><dt>Parameters</dt><dd>
  2206. <table class="params">
  2207. <tr><td class="paramdir">[in]</td><td class="paramname">fatTime</td><td>The time field from a directory entry. </td></tr>
  2208. </table>
  2209. </dd>
  2210. </dl>
  2211. </div>
  2212. </div>
  2213. <a class="anchor" id="a4e7e56ba52ca17c602af1b85684b09a9"></a>
  2214. <div class="memitem">
  2215. <div class="memproto">
  2216. <table class="mlabels">
  2217. <tr>
  2218. <td class="mlabels-left">
  2219. <table class="memname">
  2220. <tr>
  2221. <td class="memname">void FatFile::printFatTime </td>
  2222. <td>(</td>
  2223. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  2224. <td class="paramname"><em>pr</em>, </td>
  2225. </tr>
  2226. <tr>
  2227. <td class="paramkey"></td>
  2228. <td></td>
  2229. <td class="paramtype">uint16_t&#160;</td>
  2230. <td class="paramname"><em>fatTime</em>&#160;</td>
  2231. </tr>
  2232. <tr>
  2233. <td></td>
  2234. <td>)</td>
  2235. <td></td><td></td>
  2236. </tr>
  2237. </table>
  2238. </td>
  2239. <td class="mlabels-right">
  2240. <span class="mlabels"><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  2241. </tr>
  2242. </table>
  2243. </div><div class="memdoc">
  2244. <p>Print a directory time field.</p>
  2245. <p>Format is hh:mm:ss.</p>
  2246. <dl class="params"><dt>Parameters</dt><dd>
  2247. <table class="params">
  2248. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output. </td></tr>
  2249. <tr><td class="paramdir">[in]</td><td class="paramname">fatTime</td><td>The time field from a directory entry. </td></tr>
  2250. </table>
  2251. </dd>
  2252. </dl>
  2253. </div>
  2254. </div>
  2255. <a class="anchor" id="a7478cad0f9e5079311b9e1fa558016ff"></a>
  2256. <div class="memitem">
  2257. <div class="memproto">
  2258. <table class="mlabels">
  2259. <tr>
  2260. <td class="mlabels-left">
  2261. <table class="memname">
  2262. <tr>
  2263. <td class="memname">int FatFile::printField </td>
  2264. <td>(</td>
  2265. <td class="paramtype">float&#160;</td>
  2266. <td class="paramname"><em>value</em>, </td>
  2267. </tr>
  2268. <tr>
  2269. <td class="paramkey"></td>
  2270. <td></td>
  2271. <td class="paramtype">char&#160;</td>
  2272. <td class="paramname"><em>term</em>, </td>
  2273. </tr>
  2274. <tr>
  2275. <td class="paramkey"></td>
  2276. <td></td>
  2277. <td class="paramtype">uint8_t&#160;</td>
  2278. <td class="paramname"><em>prec</em> = <code>2</code>&#160;</td>
  2279. </tr>
  2280. <tr>
  2281. <td></td>
  2282. <td>)</td>
  2283. <td></td><td></td>
  2284. </tr>
  2285. </table>
  2286. </td>
  2287. <td class="mlabels-right">
  2288. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2289. </tr>
  2290. </table>
  2291. </div><div class="memdoc">
  2292. <p>Print a number followed by a field terminator. </p><dl class="params"><dt>Parameters</dt><dd>
  2293. <table class="params">
  2294. <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The number to be printed. </td></tr>
  2295. <tr><td class="paramdir">[in]</td><td class="paramname">term</td><td>The field terminator. Use '\n' for CR LF. </td></tr>
  2296. <tr><td class="paramdir">[in]</td><td class="paramname">prec</td><td>Number of digits after decimal point. </td></tr>
  2297. </table>
  2298. </dd>
  2299. </dl>
  2300. <dl class="section return"><dt>Returns</dt><dd>The number of bytes written or -1 if an error occurs. </dd></dl>
  2301. </div>
  2302. </div>
  2303. <a class="anchor" id="abd3e1747511216462b3ef98167156cbb"></a>
  2304. <div class="memitem">
  2305. <div class="memproto">
  2306. <table class="mlabels">
  2307. <tr>
  2308. <td class="mlabels-left">
  2309. <table class="memname">
  2310. <tr>
  2311. <td class="memname">int FatFile::printField </td>
  2312. <td>(</td>
  2313. <td class="paramtype">int16_t&#160;</td>
  2314. <td class="paramname"><em>value</em>, </td>
  2315. </tr>
  2316. <tr>
  2317. <td class="paramkey"></td>
  2318. <td></td>
  2319. <td class="paramtype">char&#160;</td>
  2320. <td class="paramname"><em>term</em>&#160;</td>
  2321. </tr>
  2322. <tr>
  2323. <td></td>
  2324. <td>)</td>
  2325. <td></td><td></td>
  2326. </tr>
  2327. </table>
  2328. </td>
  2329. <td class="mlabels-right">
  2330. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2331. </tr>
  2332. </table>
  2333. </div><div class="memdoc">
  2334. <p>Print a number followed by a field terminator. </p><dl class="params"><dt>Parameters</dt><dd>
  2335. <table class="params">
  2336. <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The number to be printed. </td></tr>
  2337. <tr><td class="paramdir">[in]</td><td class="paramname">term</td><td>The field terminator. Use '\n' for CR LF. </td></tr>
  2338. </table>
  2339. </dd>
  2340. </dl>
  2341. <dl class="section return"><dt>Returns</dt><dd>The number of bytes written or -1 if an error occurs. </dd></dl>
  2342. </div>
  2343. </div>
  2344. <a class="anchor" id="a9972c2419c293ef9c382bff666b9ae4d"></a>
  2345. <div class="memitem">
  2346. <div class="memproto">
  2347. <table class="mlabels">
  2348. <tr>
  2349. <td class="mlabels-left">
  2350. <table class="memname">
  2351. <tr>
  2352. <td class="memname">int FatFile::printField </td>
  2353. <td>(</td>
  2354. <td class="paramtype">uint16_t&#160;</td>
  2355. <td class="paramname"><em>value</em>, </td>
  2356. </tr>
  2357. <tr>
  2358. <td class="paramkey"></td>
  2359. <td></td>
  2360. <td class="paramtype">char&#160;</td>
  2361. <td class="paramname"><em>term</em>&#160;</td>
  2362. </tr>
  2363. <tr>
  2364. <td></td>
  2365. <td>)</td>
  2366. <td></td><td></td>
  2367. </tr>
  2368. </table>
  2369. </td>
  2370. <td class="mlabels-right">
  2371. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2372. </tr>
  2373. </table>
  2374. </div><div class="memdoc">
  2375. <p>Print a number followed by a field terminator. </p><dl class="params"><dt>Parameters</dt><dd>
  2376. <table class="params">
  2377. <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The number to be printed. </td></tr>
  2378. <tr><td class="paramdir">[in]</td><td class="paramname">term</td><td>The field terminator. Use '\n' for CR LF. </td></tr>
  2379. </table>
  2380. </dd>
  2381. </dl>
  2382. <dl class="section return"><dt>Returns</dt><dd>The number of bytes written or -1 if an error occurs. </dd></dl>
  2383. </div>
  2384. </div>
  2385. <a class="anchor" id="a41b3b32dd8482429b74c7af3432d6cf8"></a>
  2386. <div class="memitem">
  2387. <div class="memproto">
  2388. <table class="mlabels">
  2389. <tr>
  2390. <td class="mlabels-left">
  2391. <table class="memname">
  2392. <tr>
  2393. <td class="memname">int FatFile::printField </td>
  2394. <td>(</td>
  2395. <td class="paramtype">int32_t&#160;</td>
  2396. <td class="paramname"><em>value</em>, </td>
  2397. </tr>
  2398. <tr>
  2399. <td class="paramkey"></td>
  2400. <td></td>
  2401. <td class="paramtype">char&#160;</td>
  2402. <td class="paramname"><em>term</em>&#160;</td>
  2403. </tr>
  2404. <tr>
  2405. <td></td>
  2406. <td>)</td>
  2407. <td></td><td></td>
  2408. </tr>
  2409. </table>
  2410. </td>
  2411. <td class="mlabels-right">
  2412. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2413. </tr>
  2414. </table>
  2415. </div><div class="memdoc">
  2416. <p>Print a number followed by a field terminator. </p><dl class="params"><dt>Parameters</dt><dd>
  2417. <table class="params">
  2418. <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The number to be printed. </td></tr>
  2419. <tr><td class="paramdir">[in]</td><td class="paramname">term</td><td>The field terminator. Use '\n' for CR LF. </td></tr>
  2420. </table>
  2421. </dd>
  2422. </dl>
  2423. <dl class="section return"><dt>Returns</dt><dd>The number of bytes written or -1 if an error occurs. </dd></dl>
  2424. </div>
  2425. </div>
  2426. <a class="anchor" id="a097240f08baadeb1c64b63eab9afb088"></a>
  2427. <div class="memitem">
  2428. <div class="memproto">
  2429. <table class="mlabels">
  2430. <tr>
  2431. <td class="mlabels-left">
  2432. <table class="memname">
  2433. <tr>
  2434. <td class="memname">int FatFile::printField </td>
  2435. <td>(</td>
  2436. <td class="paramtype">uint32_t&#160;</td>
  2437. <td class="paramname"><em>value</em>, </td>
  2438. </tr>
  2439. <tr>
  2440. <td class="paramkey"></td>
  2441. <td></td>
  2442. <td class="paramtype">char&#160;</td>
  2443. <td class="paramname"><em>term</em>&#160;</td>
  2444. </tr>
  2445. <tr>
  2446. <td></td>
  2447. <td>)</td>
  2448. <td></td><td></td>
  2449. </tr>
  2450. </table>
  2451. </td>
  2452. <td class="mlabels-right">
  2453. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2454. </tr>
  2455. </table>
  2456. </div><div class="memdoc">
  2457. <p>Print a number followed by a field terminator. </p><dl class="params"><dt>Parameters</dt><dd>
  2458. <table class="params">
  2459. <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The number to be printed. </td></tr>
  2460. <tr><td class="paramdir">[in]</td><td class="paramname">term</td><td>The field terminator. Use '\n' for CR LF. </td></tr>
  2461. </table>
  2462. </dd>
  2463. </dl>
  2464. <dl class="section return"><dt>Returns</dt><dd>The number of bytes written or -1 if an error occurs. </dd></dl>
  2465. </div>
  2466. </div>
  2467. <a class="anchor" id="a12a5d2de2737c201aa39ca1bd2ab9c47"></a>
  2468. <div class="memitem">
  2469. <div class="memproto">
  2470. <table class="mlabels">
  2471. <tr>
  2472. <td class="mlabels-left">
  2473. <table class="memname">
  2474. <tr>
  2475. <td class="memname">size_t FatFile::printFileSize </td>
  2476. <td>(</td>
  2477. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  2478. <td class="paramname"><em>pr</em></td><td>)</td>
  2479. <td></td>
  2480. </tr>
  2481. </table>
  2482. </td>
  2483. <td class="mlabels-right">
  2484. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2485. </tr>
  2486. </table>
  2487. </div><div class="memdoc">
  2488. <p>Print a file's size.</p>
  2489. <dl class="params"><dt>Parameters</dt><dd>
  2490. <table class="params">
  2491. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  2492. </table>
  2493. </dd>
  2494. </dl>
  2495. <dl class="section return"><dt>Returns</dt><dd>The number of characters printed is returned for success and zero is returned for failure. </dd></dl>
  2496. </div>
  2497. </div>
  2498. <a class="anchor" id="a05cee5df46a370bf916d3ba597c82e39"></a>
  2499. <div class="memitem">
  2500. <div class="memproto">
  2501. <table class="mlabels">
  2502. <tr>
  2503. <td class="mlabels-left">
  2504. <table class="memname">
  2505. <tr>
  2506. <td class="memname">bool FatFile::printModifyDateTime </td>
  2507. <td>(</td>
  2508. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  2509. <td class="paramname"><em>pr</em></td><td>)</td>
  2510. <td></td>
  2511. </tr>
  2512. </table>
  2513. </td>
  2514. <td class="mlabels-right">
  2515. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2516. </tr>
  2517. </table>
  2518. </div><div class="memdoc">
  2519. <p>Print a file's modify date and time</p>
  2520. <dl class="params"><dt>Parameters</dt><dd>
  2521. <table class="params">
  2522. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  2523. </table>
  2524. </dd>
  2525. </dl>
  2526. <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>
  2527. </div>
  2528. </div>
  2529. <a class="anchor" id="ad1cbc3aeb0f5193b7a26595966da9621"></a>
  2530. <div class="memitem">
  2531. <div class="memproto">
  2532. <table class="mlabels">
  2533. <tr>
  2534. <td class="mlabels-left">
  2535. <table class="memname">
  2536. <tr>
  2537. <td class="memname">size_t FatFile::printName </td>
  2538. <td>(</td>
  2539. <td class="paramname"></td><td>)</td>
  2540. <td></td>
  2541. </tr>
  2542. </table>
  2543. </td>
  2544. <td class="mlabels-right">
  2545. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  2546. </tr>
  2547. </table>
  2548. </div><div class="memdoc">
  2549. <p>Print a file's name.</p>
  2550. <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>
  2551. </div>
  2552. </div>
  2553. <a class="anchor" id="afe18a787fb8640e2d2483370c770f82f"></a>
  2554. <div class="memitem">
  2555. <div class="memproto">
  2556. <table class="mlabels">
  2557. <tr>
  2558. <td class="mlabels-left">
  2559. <table class="memname">
  2560. <tr>
  2561. <td class="memname">size_t FatFile::printName </td>
  2562. <td>(</td>
  2563. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  2564. <td class="paramname"><em>pr</em></td><td>)</td>
  2565. <td></td>
  2566. </tr>
  2567. </table>
  2568. </td>
  2569. <td class="mlabels-right">
  2570. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2571. </tr>
  2572. </table>
  2573. </div><div class="memdoc">
  2574. <p>Print a file's name</p>
  2575. <dl class="params"><dt>Parameters</dt><dd>
  2576. <table class="params">
  2577. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  2578. </table>
  2579. </dd>
  2580. </dl>
  2581. <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>
  2582. </div>
  2583. </div>
  2584. <a class="anchor" id="a791cd7aade71f609aab62ec018aea3c0"></a>
  2585. <div class="memitem">
  2586. <div class="memproto">
  2587. <table class="mlabels">
  2588. <tr>
  2589. <td class="mlabels-left">
  2590. <table class="memname">
  2591. <tr>
  2592. <td class="memname">size_t FatFile::printSFN </td>
  2593. <td>(</td>
  2594. <td class="paramtype"><a class="el" href="_fat_volume_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  2595. <td class="paramname"><em>pr</em></td><td>)</td>
  2596. <td></td>
  2597. </tr>
  2598. </table>
  2599. </td>
  2600. <td class="mlabels-right">
  2601. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2602. </tr>
  2603. </table>
  2604. </div><div class="memdoc">
  2605. <p>Print a file's Short <a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> Name.</p>
  2606. <dl class="params"><dt>Parameters</dt><dd>
  2607. <table class="params">
  2608. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  2609. </table>
  2610. </dd>
  2611. </dl>
  2612. <dl class="section return"><dt>Returns</dt><dd>The number of characters printed is returned for success and zero is returned for failure. </dd></dl>
  2613. </div>
  2614. </div>
  2615. <a class="anchor" id="a4c46a1975e66c37977bf07c58ec10b4e"></a>
  2616. <div class="memitem">
  2617. <div class="memproto">
  2618. <table class="mlabels">
  2619. <tr>
  2620. <td class="mlabels-left">
  2621. <table class="memname">
  2622. <tr>
  2623. <td class="memname">int File::read </td>
  2624. <td>(</td>
  2625. <td class="paramname"></td><td>)</td>
  2626. <td></td>
  2627. </tr>
  2628. </table>
  2629. </td>
  2630. <td class="mlabels-right">
  2631. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2632. </tr>
  2633. </table>
  2634. </div><div class="memdoc">
  2635. <p>Read the next byte from a file.</p>
  2636. <dl class="section return"><dt>Returns</dt><dd>For success return the next byte in the file as an int. If an error occurs or end of file is reached return -1. </dd></dl>
  2637. </div>
  2638. </div>
  2639. <a class="anchor" id="a200e6e0553d5b709520c9dfac9ef77dd"></a>
  2640. <div class="memitem">
  2641. <div class="memproto">
  2642. <table class="mlabels">
  2643. <tr>
  2644. <td class="mlabels-left">
  2645. <table class="memname">
  2646. <tr>
  2647. <td class="memname">int FatFile::read </td>
  2648. <td>(</td>
  2649. <td class="paramtype">void *&#160;</td>
  2650. <td class="paramname"><em>buf</em>, </td>
  2651. </tr>
  2652. <tr>
  2653. <td class="paramkey"></td>
  2654. <td></td>
  2655. <td class="paramtype">size_t&#160;</td>
  2656. <td class="paramname"><em>nbyte</em>&#160;</td>
  2657. </tr>
  2658. <tr>
  2659. <td></td>
  2660. <td>)</td>
  2661. <td></td><td></td>
  2662. </tr>
  2663. </table>
  2664. </td>
  2665. <td class="mlabels-right">
  2666. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2667. </tr>
  2668. </table>
  2669. </div><div class="memdoc">
  2670. <p>Read data from a file starting at the current position.</p>
  2671. <dl class="params"><dt>Parameters</dt><dd>
  2672. <table class="params">
  2673. <tr><td class="paramdir">[out]</td><td class="paramname">buf</td><td>Pointer to the location that will receive the data.</td></tr>
  2674. <tr><td class="paramdir">[in]</td><td class="paramname">nbyte</td><td>Maximum number of bytes to read.</td></tr>
  2675. </table>
  2676. </dd>
  2677. </dl>
  2678. <dl class="section return"><dt>Returns</dt><dd>For success <a class="el" href="class_fat_file.html#a60ae55ff6fe158c2340071d702a363c5">read()</a> returns the number of bytes read. A value less than <em>nbyte</em>, including zero, will be returned if end of file is reached. If an error occurs, <a class="el" href="class_fat_file.html#a60ae55ff6fe158c2340071d702a363c5">read()</a> returns -1. Possible errors include <a class="el" href="class_fat_file.html#a60ae55ff6fe158c2340071d702a363c5">read()</a> called before a file has been opened, corrupt file system or an I/O error occurred. </dd></dl>
  2679. </div>
  2680. </div>
  2681. <a class="anchor" id="a1325afe074c3efecff666678cd9f116a"></a>
  2682. <div class="memitem">
  2683. <div class="memproto">
  2684. <table class="mlabels">
  2685. <tr>
  2686. <td class="mlabels-left">
  2687. <table class="memname">
  2688. <tr>
  2689. <td class="memname">int8_t FatFile::readDir </td>
  2690. <td>(</td>
  2691. <td class="paramtype"><a class="el" href="_fat_structs_8h.html#a803db59d4e16a0c54a647afc6a7954e3">dir_t</a> *&#160;</td>
  2692. <td class="paramname"><em>dir</em></td><td>)</td>
  2693. <td></td>
  2694. </tr>
  2695. </table>
  2696. </td>
  2697. <td class="mlabels-right">
  2698. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2699. </tr>
  2700. </table>
  2701. </div><div class="memdoc">
  2702. <p>Read the next directory entry from a directory file.</p>
  2703. <dl class="params"><dt>Parameters</dt><dd>
  2704. <table class="params">
  2705. <tr><td class="paramdir">[out]</td><td class="paramname">dir</td><td>The dir_t struct that will receive the data.</td></tr>
  2706. </table>
  2707. </dd>
  2708. </dl>
  2709. <dl class="section return"><dt>Returns</dt><dd>For success <a class="el" href="class_fat_file.html#a1325afe074c3efecff666678cd9f116a">readDir()</a> returns the number of bytes read. A value of zero will be returned if end of file is reached. If an error occurs, <a class="el" href="class_fat_file.html#a1325afe074c3efecff666678cd9f116a">readDir()</a> returns -1. Possible errors include <a class="el" href="class_fat_file.html#a1325afe074c3efecff666678cd9f116a">readDir()</a> called before a directory has been opened, this is not a directory file or an I/O error occurred. </dd></dl>
  2710. </div>
  2711. </div>
  2712. <a class="anchor" id="ac837a537fbcca14c7aa390c5fc9f4e7c"></a>
  2713. <div class="memitem">
  2714. <div class="memproto">
  2715. <table class="mlabels">
  2716. <tr>
  2717. <td class="mlabels-left">
  2718. <table class="memname">
  2719. <tr>
  2720. <td class="memname">bool FatFile::remove </td>
  2721. <td>(</td>
  2722. <td class="paramname"></td><td>)</td>
  2723. <td></td>
  2724. </tr>
  2725. </table>
  2726. </td>
  2727. <td class="mlabels-right">
  2728. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2729. </tr>
  2730. </table>
  2731. </div><div class="memdoc">
  2732. <p>Remove a file.</p>
  2733. <p>The directory entry and all data for the file are deleted.</p>
  2734. <dl class="section note"><dt>Note</dt><dd>This function should not be used to delete the 8.3 version of a file that has a long name. For example if a file has the long name "New Text Document.txt" you should not delete the 8.3 name "NEWTEX~1.TXT".</dd></dl>
  2735. <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>
  2736. </div>
  2737. </div>
  2738. <a class="anchor" id="afe820bbb056863e91ec482961c8dc695"></a>
  2739. <div class="memitem">
  2740. <div class="memproto">
  2741. <table class="mlabels">
  2742. <tr>
  2743. <td class="mlabels-left">
  2744. <table class="memname">
  2745. <tr>
  2746. <td class="memname">bool FatFile::remove </td>
  2747. <td>(</td>
  2748. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  2749. <td class="paramname"><em>dirFile</em>, </td>
  2750. </tr>
  2751. <tr>
  2752. <td class="paramkey"></td>
  2753. <td></td>
  2754. <td class="paramtype">const char *&#160;</td>
  2755. <td class="paramname"><em>path</em>&#160;</td>
  2756. </tr>
  2757. <tr>
  2758. <td></td>
  2759. <td>)</td>
  2760. <td></td><td></td>
  2761. </tr>
  2762. </table>
  2763. </td>
  2764. <td class="mlabels-right">
  2765. <span class="mlabels"><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  2766. </tr>
  2767. </table>
  2768. </div><div class="memdoc">
  2769. <p>Remove a file.</p>
  2770. <p>The directory entry and all data for the file are deleted.</p>
  2771. <dl class="params"><dt>Parameters</dt><dd>
  2772. <table class="params">
  2773. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>The directory that contains the file. </td></tr>
  2774. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>Path for the file to be removed.</td></tr>
  2775. </table>
  2776. </dd>
  2777. </dl>
  2778. <dl class="section note"><dt>Note</dt><dd>This function should not be used to delete the 8.3 version of a file that has a long name. For example if a file has the long name "New Text Document.txt" you should not delete the 8.3 name "NEWTEX~1.TXT".</dd></dl>
  2779. <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>
  2780. </div>
  2781. </div>
  2782. <a class="anchor" id="a4b42f2454ff462555c07ea094a92a1e0"></a>
  2783. <div class="memitem">
  2784. <div class="memproto">
  2785. <table class="mlabels">
  2786. <tr>
  2787. <td class="mlabels-left">
  2788. <table class="memname">
  2789. <tr>
  2790. <td class="memname">bool FatFile::rename </td>
  2791. <td>(</td>
  2792. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  2793. <td class="paramname"><em>dirFile</em>, </td>
  2794. </tr>
  2795. <tr>
  2796. <td class="paramkey"></td>
  2797. <td></td>
  2798. <td class="paramtype">const char *&#160;</td>
  2799. <td class="paramname"><em>newPath</em>&#160;</td>
  2800. </tr>
  2801. <tr>
  2802. <td></td>
  2803. <td>)</td>
  2804. <td></td><td></td>
  2805. </tr>
  2806. </table>
  2807. </td>
  2808. <td class="mlabels-right">
  2809. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2810. </tr>
  2811. </table>
  2812. </div><div class="memdoc">
  2813. <p>Rename a file or subdirectory.</p>
  2814. <dl class="params"><dt>Parameters</dt><dd>
  2815. <table class="params">
  2816. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>Directory for the new path. </td></tr>
  2817. <tr><td class="paramdir">[in]</td><td class="paramname">newPath</td><td>New path name for the file/directory.</td></tr>
  2818. </table>
  2819. </dd>
  2820. </dl>
  2821. <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>
  2822. </div>
  2823. </div>
  2824. <a class="anchor" id="a5aac6e0b3cb08fc8b8668e916a8b0ca5"></a>
  2825. <div class="memitem">
  2826. <div class="memproto">
  2827. <table class="mlabels">
  2828. <tr>
  2829. <td class="mlabels-left">
  2830. <table class="memname">
  2831. <tr>
  2832. <td class="memname">void FatFile::rewind </td>
  2833. <td>(</td>
  2834. <td class="paramname"></td><td>)</td>
  2835. <td></td>
  2836. </tr>
  2837. </table>
  2838. </td>
  2839. <td class="mlabels-right">
  2840. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  2841. </tr>
  2842. </table>
  2843. </div><div class="memdoc">
  2844. <p>Set the file's current position to zero. </p>
  2845. </div>
  2846. </div>
  2847. <a class="anchor" id="ae1419603dea25a6c8480b941d7ac63a3"></a>
  2848. <div class="memitem">
  2849. <div class="memproto">
  2850. <table class="mlabels">
  2851. <tr>
  2852. <td class="mlabels-left">
  2853. <table class="memname">
  2854. <tr>
  2855. <td class="memname">void File::rewindDirectory </td>
  2856. <td>(</td>
  2857. <td class="paramname"></td><td>)</td>
  2858. <td></td>
  2859. </tr>
  2860. </table>
  2861. </td>
  2862. <td class="mlabels-right">
  2863. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2864. </tr>
  2865. </table>
  2866. </div><div class="memdoc">
  2867. <p>Rewind a file if it is a directory </p>
  2868. </div>
  2869. </div>
  2870. <a class="anchor" id="a9515bac181d33e7f0125e88fa2ccd283"></a>
  2871. <div class="memitem">
  2872. <div class="memproto">
  2873. <table class="mlabels">
  2874. <tr>
  2875. <td class="mlabels-left">
  2876. <table class="memname">
  2877. <tr>
  2878. <td class="memname">bool FatFile::rmdir </td>
  2879. <td>(</td>
  2880. <td class="paramname"></td><td>)</td>
  2881. <td></td>
  2882. </tr>
  2883. </table>
  2884. </td>
  2885. <td class="mlabels-right">
  2886. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2887. </tr>
  2888. </table>
  2889. </div><div class="memdoc">
  2890. <p>Remove a directory file.</p>
  2891. <p>The directory file will be removed only if it is empty and is not the root directory. <a class="el" href="class_fat_file.html#a9515bac181d33e7f0125e88fa2ccd283">rmdir()</a> follows DOS and Windows and ignores the read-only attribute for the directory.</p>
  2892. <dl class="section note"><dt>Note</dt><dd>This function should not be used to delete the 8.3 version of a directory that has a long name. For example if a directory has the long name "New folder" you should not delete the 8.3 name "NEWFOL~1".</dd></dl>
  2893. <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>
  2894. </div>
  2895. </div>
  2896. <a class="anchor" id="ac780a80526f86d3def701ecdc99d8bfe"></a>
  2897. <div class="memitem">
  2898. <div class="memproto">
  2899. <table class="mlabels">
  2900. <tr>
  2901. <td class="mlabels-left">
  2902. <table class="memname">
  2903. <tr>
  2904. <td class="memname">bool FatFile::rmRfStar </td>
  2905. <td>(</td>
  2906. <td class="paramname"></td><td>)</td>
  2907. <td></td>
  2908. </tr>
  2909. </table>
  2910. </td>
  2911. <td class="mlabels-right">
  2912. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  2913. </tr>
  2914. </table>
  2915. </div><div class="memdoc">
  2916. <p>Recursively delete a directory and all contained files.</p>
  2917. <p>This is like the Unix/Linux 'rm -rf *' if called with the root directory hence the name.</p>
  2918. <p>Warning - This will remove all contents of the directory including subdirectories. The directory will then be removed if it is not root. The read-only attribute for files will be ignored.</p>
  2919. <dl class="section note"><dt>Note</dt><dd>This function should not be used to delete the 8.3 version of a directory that has a long name. See <a class="el" href="class_fat_file.html#ac837a537fbcca14c7aa390c5fc9f4e7c">remove()</a> and <a class="el" href="class_fat_file.html#a9515bac181d33e7f0125e88fa2ccd283">rmdir()</a>.</dd></dl>
  2920. <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>
  2921. </div>
  2922. </div>
  2923. <a class="anchor" id="a2d41ea52356b769e05e1242685758c08"></a>
  2924. <div class="memitem">
  2925. <div class="memproto">
  2926. <table class="mlabels">
  2927. <tr>
  2928. <td class="mlabels-left">
  2929. <table class="memname">
  2930. <tr>
  2931. <td class="memname">bool File::seek </td>
  2932. <td>(</td>
  2933. <td class="paramtype">uint32_t&#160;</td>
  2934. <td class="paramname"><em>pos</em></td><td>)</td>
  2935. <td></td>
  2936. </tr>
  2937. </table>
  2938. </td>
  2939. <td class="mlabels-right">
  2940. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2941. </tr>
  2942. </table>
  2943. </div><div class="memdoc">
  2944. <p>Seek to a new position in the file, which must be between 0 and the size of the file (inclusive).</p>
  2945. <dl class="params"><dt>Parameters</dt><dd>
  2946. <table class="params">
  2947. <tr><td class="paramdir">[in]</td><td class="paramname">pos</td><td>the new file position. </td></tr>
  2948. </table>
  2949. </dd>
  2950. </dl>
  2951. <dl class="section return"><dt>Returns</dt><dd>true for success else false. </dd></dl>
  2952. </div>
  2953. </div>
  2954. <a class="anchor" id="a5812037ea30777cc350698ad26f2c73f"></a>
  2955. <div class="memitem">
  2956. <div class="memproto">
  2957. <table class="mlabels">
  2958. <tr>
  2959. <td class="mlabels-left">
  2960. <table class="memname">
  2961. <tr>
  2962. <td class="memname">bool FatFile::seekCur </td>
  2963. <td>(</td>
  2964. <td class="paramtype">int32_t&#160;</td>
  2965. <td class="paramname"><em>offset</em></td><td>)</td>
  2966. <td></td>
  2967. </tr>
  2968. </table>
  2969. </td>
  2970. <td class="mlabels-right">
  2971. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  2972. </tr>
  2973. </table>
  2974. </div><div class="memdoc">
  2975. <p>Set the files position to current position + <em>pos</em>. See <a class="el" href="class_fat_file.html#ab067190d25733ed7e697d9890f61fd7a">seekSet()</a>. </p><dl class="params"><dt>Parameters</dt><dd>
  2976. <table class="params">
  2977. <tr><td class="paramdir">[in]</td><td class="paramname">offset</td><td>The new position in bytes from the current position. </td></tr>
  2978. </table>
  2979. </dd>
  2980. </dl>
  2981. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  2982. </div>
  2983. </div>
  2984. <a class="anchor" id="a84f677f4e75ef6fa2eb632f4cdf6b486"></a>
  2985. <div class="memitem">
  2986. <div class="memproto">
  2987. <table class="mlabels">
  2988. <tr>
  2989. <td class="mlabels-left">
  2990. <table class="memname">
  2991. <tr>
  2992. <td class="memname">bool FatFile::seekEnd </td>
  2993. <td>(</td>
  2994. <td class="paramtype">int32_t&#160;</td>
  2995. <td class="paramname"><em>offset</em> = <code>0</code></td><td>)</td>
  2996. <td></td>
  2997. </tr>
  2998. </table>
  2999. </td>
  3000. <td class="mlabels-right">
  3001. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  3002. </tr>
  3003. </table>
  3004. </div><div class="memdoc">
  3005. <p>Set the files position to end-of-file + <em>offset</em>. See <a class="el" href="class_fat_file.html#ab067190d25733ed7e697d9890f61fd7a">seekSet()</a>. Can't be used for directory files since file size is not defined. </p><dl class="params"><dt>Parameters</dt><dd>
  3006. <table class="params">
  3007. <tr><td class="paramdir">[in]</td><td class="paramname">offset</td><td>The new position in bytes from end-of-file. </td></tr>
  3008. </table>
  3009. </dd>
  3010. </dl>
  3011. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  3012. </div>
  3013. </div>
  3014. <a class="anchor" id="ab067190d25733ed7e697d9890f61fd7a"></a>
  3015. <div class="memitem">
  3016. <div class="memproto">
  3017. <table class="mlabels">
  3018. <tr>
  3019. <td class="mlabels-left">
  3020. <table class="memname">
  3021. <tr>
  3022. <td class="memname">bool FatFile::seekSet </td>
  3023. <td>(</td>
  3024. <td class="paramtype">uint32_t&#160;</td>
  3025. <td class="paramname"><em>pos</em></td><td>)</td>
  3026. <td></td>
  3027. </tr>
  3028. </table>
  3029. </td>
  3030. <td class="mlabels-right">
  3031. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  3032. </tr>
  3033. </table>
  3034. </div><div class="memdoc">
  3035. <p>Sets a file's position.</p>
  3036. <dl class="params"><dt>Parameters</dt><dd>
  3037. <table class="params">
  3038. <tr><td class="paramdir">[in]</td><td class="paramname">pos</td><td>The new position in bytes from the beginning of the file.</td></tr>
  3039. </table>
  3040. </dd>
  3041. </dl>
  3042. <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>
  3043. </div>
  3044. </div>
  3045. <a class="anchor" id="a360ef9c05e677271bed6c0a4d663634c"></a>
  3046. <div class="memitem">
  3047. <div class="memproto">
  3048. <table class="mlabels">
  3049. <tr>
  3050. <td class="mlabels-left">
  3051. <table class="memname">
  3052. <tr>
  3053. <td class="memname">static bool FatFile::setCwd </td>
  3054. <td>(</td>
  3055. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  3056. <td class="paramname"><em>dir</em></td><td>)</td>
  3057. <td></td>
  3058. </tr>
  3059. </table>
  3060. </td>
  3061. <td class="mlabels-right">
  3062. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">static</span><span class="mlabel">inherited</span></span> </td>
  3063. </tr>
  3064. </table>
  3065. </div><div class="memdoc">
  3066. <p>Set the current working directory.</p>
  3067. <dl class="params"><dt>Parameters</dt><dd>
  3068. <table class="params">
  3069. <tr><td class="paramdir">[in]</td><td class="paramname">dir</td><td>New current working directory.</td></tr>
  3070. </table>
  3071. </dd>
  3072. </dl>
  3073. <dl class="section return"><dt>Returns</dt><dd>true for success else false. </dd></dl>
  3074. </div>
  3075. </div>
  3076. <a class="anchor" id="acf264de4e3ca36c5e8a39e56173c9044"></a>
  3077. <div class="memitem">
  3078. <div class="memproto">
  3079. <table class="mlabels">
  3080. <tr>
  3081. <td class="mlabels-left">
  3082. <table class="memname">
  3083. <tr>
  3084. <td class="memname">void FatFile::setpos </td>
  3085. <td>(</td>
  3086. <td class="paramtype"><a class="el" href="struct_fat_pos__t.html">FatPos_t</a> *&#160;</td>
  3087. <td class="paramname"><em>pos</em></td><td>)</td>
  3088. <td></td>
  3089. </tr>
  3090. </table>
  3091. </td>
  3092. <td class="mlabels-right">
  3093. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  3094. </tr>
  3095. </table>
  3096. </div><div class="memdoc">
  3097. <p>set position for streams </p><dl class="params"><dt>Parameters</dt><dd>
  3098. <table class="params">
  3099. <tr><td class="paramdir">[out]</td><td class="paramname">pos</td><td>struct with value for new position </td></tr>
  3100. </table>
  3101. </dd>
  3102. </dl>
  3103. </div>
  3104. </div>
  3105. <a class="anchor" id="a603d3cd3319142d00a7ebd434970b017"></a>
  3106. <div class="memitem">
  3107. <div class="memproto">
  3108. <table class="mlabels">
  3109. <tr>
  3110. <td class="mlabels-left">
  3111. <table class="memname">
  3112. <tr>
  3113. <td class="memname">uint32_t File::size </td>
  3114. <td>(</td>
  3115. <td class="paramname"></td><td>)</td>
  3116. <td></td>
  3117. </tr>
  3118. </table>
  3119. </td>
  3120. <td class="mlabels-right">
  3121. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  3122. </tr>
  3123. </table>
  3124. </div><div class="memdoc">
  3125. <dl class="section return"><dt>Returns</dt><dd>the file's size. </dd></dl>
  3126. </div>
  3127. </div>
  3128. <a class="anchor" id="a67f3dc4896c542d695e11aac927f585e"></a>
  3129. <div class="memitem">
  3130. <div class="memproto">
  3131. <table class="mlabels">
  3132. <tr>
  3133. <td class="mlabels-left">
  3134. <table class="memname">
  3135. <tr>
  3136. <td class="memname">bool FatFile::sync </td>
  3137. <td>(</td>
  3138. <td class="paramname"></td><td>)</td>
  3139. <td></td>
  3140. </tr>
  3141. </table>
  3142. </td>
  3143. <td class="mlabels-right">
  3144. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  3145. </tr>
  3146. </table>
  3147. </div><div class="memdoc">
  3148. <p>The <a class="el" href="class_fat_file.html#a67f3dc4896c542d695e11aac927f585e">sync()</a> call causes all modified data and directory fields to be written to the storage device.</p>
  3149. <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>
  3150. </div>
  3151. </div>
  3152. <a class="anchor" id="aa53a8d1d2467ad9af7d61cbf8ee85243"></a>
  3153. <div class="memitem">
  3154. <div class="memproto">
  3155. <table class="mlabels">
  3156. <tr>
  3157. <td class="mlabels-left">
  3158. <table class="memname">
  3159. <tr>
  3160. <td class="memname">bool FatFile::timestamp </td>
  3161. <td>(</td>
  3162. <td class="paramtype"><a class="el" href="class_fat_file.html">FatFile</a> *&#160;</td>
  3163. <td class="paramname"><em>file</em></td><td>)</td>
  3164. <td></td>
  3165. </tr>
  3166. </table>
  3167. </td>
  3168. <td class="mlabels-right">
  3169. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  3170. </tr>
  3171. </table>
  3172. </div><div class="memdoc">
  3173. <p>Copy a file's timestamps</p>
  3174. <dl class="params"><dt>Parameters</dt><dd>
  3175. <table class="params">
  3176. <tr><td class="paramdir">[in]</td><td class="paramname">file</td><td><a class="el" href="class_file.html" title="Arduino SD.h style File API. ">File</a> to copy timestamps from.</td></tr>
  3177. </table>
  3178. </dd>
  3179. </dl>
  3180. <dl class="section note"><dt>Note</dt><dd>Modify and access timestamps may be overwritten if a date time callback function has been set by <a class="el" href="class_fat_file.html#a29a623f50df057e8b49045ba6611ec2b">dateTimeCallback()</a>.</dd></dl>
  3181. <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>
  3182. </div>
  3183. </div>
  3184. <a class="anchor" id="a56dabdf73833b7e961c4530eb8e16d23"></a>
  3185. <div class="memitem">
  3186. <div class="memproto">
  3187. <table class="mlabels">
  3188. <tr>
  3189. <td class="mlabels-left">
  3190. <table class="memname">
  3191. <tr>
  3192. <td class="memname">bool FatFile::timestamp </td>
  3193. <td>(</td>
  3194. <td class="paramtype">uint8_t&#160;</td>
  3195. <td class="paramname"><em>flags</em>, </td>
  3196. </tr>
  3197. <tr>
  3198. <td class="paramkey"></td>
  3199. <td></td>
  3200. <td class="paramtype">uint16_t&#160;</td>
  3201. <td class="paramname"><em>year</em>, </td>
  3202. </tr>
  3203. <tr>
  3204. <td class="paramkey"></td>
  3205. <td></td>
  3206. <td class="paramtype">uint8_t&#160;</td>
  3207. <td class="paramname"><em>month</em>, </td>
  3208. </tr>
  3209. <tr>
  3210. <td class="paramkey"></td>
  3211. <td></td>
  3212. <td class="paramtype">uint8_t&#160;</td>
  3213. <td class="paramname"><em>day</em>, </td>
  3214. </tr>
  3215. <tr>
  3216. <td class="paramkey"></td>
  3217. <td></td>
  3218. <td class="paramtype">uint8_t&#160;</td>
  3219. <td class="paramname"><em>hour</em>, </td>
  3220. </tr>
  3221. <tr>
  3222. <td class="paramkey"></td>
  3223. <td></td>
  3224. <td class="paramtype">uint8_t&#160;</td>
  3225. <td class="paramname"><em>minute</em>, </td>
  3226. </tr>
  3227. <tr>
  3228. <td class="paramkey"></td>
  3229. <td></td>
  3230. <td class="paramtype">uint8_t&#160;</td>
  3231. <td class="paramname"><em>second</em>&#160;</td>
  3232. </tr>
  3233. <tr>
  3234. <td></td>
  3235. <td>)</td>
  3236. <td></td><td></td>
  3237. </tr>
  3238. </table>
  3239. </td>
  3240. <td class="mlabels-right">
  3241. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  3242. </tr>
  3243. </table>
  3244. </div><div class="memdoc">
  3245. <p>Set a file's timestamps in its directory entry.</p>
  3246. <dl class="params"><dt>Parameters</dt><dd>
  3247. <table class="params">
  3248. <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>Values for <em>flags</em> are constructed by a bitwise-inclusive OR of flags from the following list</td></tr>
  3249. </table>
  3250. </dd>
  3251. </dl>
  3252. <p>T_ACCESS - Set the file's last access date.</p>
  3253. <p>T_CREATE - Set the file's creation date and time.</p>
  3254. <p>T_WRITE - Set the file's last write/modification date and time.</p>
  3255. <dl class="params"><dt>Parameters</dt><dd>
  3256. <table class="params">
  3257. <tr><td class="paramdir">[in]</td><td class="paramname">year</td><td>Valid range 1980 - 2107 inclusive.</td></tr>
  3258. <tr><td class="paramdir">[in]</td><td class="paramname">month</td><td>Valid range 1 - 12 inclusive.</td></tr>
  3259. <tr><td class="paramdir">[in]</td><td class="paramname">day</td><td>Valid range 1 - 31 inclusive.</td></tr>
  3260. <tr><td class="paramdir">[in]</td><td class="paramname">hour</td><td>Valid range 0 - 23 inclusive.</td></tr>
  3261. <tr><td class="paramdir">[in]</td><td class="paramname">minute</td><td>Valid range 0 - 59 inclusive.</td></tr>
  3262. <tr><td class="paramdir">[in]</td><td class="paramname">second</td><td>Valid range 0 - 59 inclusive</td></tr>
  3263. </table>
  3264. </dd>
  3265. </dl>
  3266. <dl class="section note"><dt>Note</dt><dd>It is possible to set an invalid date since there is no check for the number of days in a month.</dd>
  3267. <dd>
  3268. Modify and access timestamps may be overwritten if a date time callback function has been set by <a class="el" href="class_fat_file.html#a29a623f50df057e8b49045ba6611ec2b">dateTimeCallback()</a>.</dd></dl>
  3269. <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>
  3270. </div>
  3271. </div>
  3272. <a class="anchor" id="aa6e663098a578635d37d92e82d18d616"></a>
  3273. <div class="memitem">
  3274. <div class="memproto">
  3275. <table class="mlabels">
  3276. <tr>
  3277. <td class="mlabels-left">
  3278. <table class="memname">
  3279. <tr>
  3280. <td class="memname">bool FatFile::truncate </td>
  3281. <td>(</td>
  3282. <td class="paramtype">uint32_t&#160;</td>
  3283. <td class="paramname"><em>length</em></td><td>)</td>
  3284. <td></td>
  3285. </tr>
  3286. </table>
  3287. </td>
  3288. <td class="mlabels-right">
  3289. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  3290. </tr>
  3291. </table>
  3292. </div><div class="memdoc">
  3293. <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>
  3294. <dl class="params"><dt>Parameters</dt><dd>
  3295. <table class="params">
  3296. <tr><td class="paramdir">[in]</td><td class="paramname">length</td><td>The desired length for the file.</td></tr>
  3297. </table>
  3298. </dd>
  3299. </dl>
  3300. <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>
  3301. </div>
  3302. </div>
  3303. <a class="anchor" id="a3c64bd8a9abb9a6461d4addb405614df"></a>
  3304. <div class="memitem">
  3305. <div class="memproto">
  3306. <table class="mlabels">
  3307. <tr>
  3308. <td class="mlabels-left">
  3309. <table class="memname">
  3310. <tr>
  3311. <td class="memname"><a class="el" href="class_fat_volume.html">FatVolume</a>* FatFile::volume </td>
  3312. <td>(</td>
  3313. <td class="paramname"></td><td>)</td>
  3314. <td> const</td>
  3315. </tr>
  3316. </table>
  3317. </td>
  3318. <td class="mlabels-right">
  3319. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  3320. </tr>
  3321. </table>
  3322. </div><div class="memdoc">
  3323. <dl class="section return"><dt>Returns</dt><dd><a class="el" href="class_fat_volume.html" title="Access FAT16 and FAT32 volumes on raw file devices. ">FatVolume</a> that contains this file. </dd></dl>
  3324. </div>
  3325. </div>
  3326. <a class="anchor" id="a618a6b2b7e81bfb93e0d3c158f614f90"></a>
  3327. <div class="memitem">
  3328. <div class="memproto">
  3329. <table class="mlabels">
  3330. <tr>
  3331. <td class="mlabels-left">
  3332. <table class="memname">
  3333. <tr>
  3334. <td class="memname">size_t File::write </td>
  3335. <td>(</td>
  3336. <td class="paramtype">uint8_t&#160;</td>
  3337. <td class="paramname"><em>b</em></td><td>)</td>
  3338. <td></td>
  3339. </tr>
  3340. </table>
  3341. </td>
  3342. <td class="mlabels-right">
  3343. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  3344. </tr>
  3345. </table>
  3346. </div><div class="memdoc">
  3347. <p>Write a byte to a file. Required by the Arduino Print class. </p><dl class="params"><dt>Parameters</dt><dd>
  3348. <table class="params">
  3349. <tr><td class="paramdir">[in]</td><td class="paramname">b</td><td>the byte to be written. Use getWriteError to check for errors. </td></tr>
  3350. </table>
  3351. </dd>
  3352. </dl>
  3353. <dl class="section return"><dt>Returns</dt><dd>1 for success and 0 for failure. </dd></dl>
  3354. </div>
  3355. </div>
  3356. <a class="anchor" id="aa531c1641a2363e1f6b9d103f37433da"></a>
  3357. <div class="memitem">
  3358. <div class="memproto">
  3359. <table class="mlabels">
  3360. <tr>
  3361. <td class="mlabels-left">
  3362. <table class="memname">
  3363. <tr>
  3364. <td class="memname">size_t File::write </td>
  3365. <td>(</td>
  3366. <td class="paramtype">const uint8_t *&#160;</td>
  3367. <td class="paramname"><em>buf</em>, </td>
  3368. </tr>
  3369. <tr>
  3370. <td class="paramkey"></td>
  3371. <td></td>
  3372. <td class="paramtype">size_t&#160;</td>
  3373. <td class="paramname"><em>size</em>&#160;</td>
  3374. </tr>
  3375. <tr>
  3376. <td></td>
  3377. <td>)</td>
  3378. <td></td><td></td>
  3379. </tr>
  3380. </table>
  3381. </td>
  3382. <td class="mlabels-right">
  3383. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  3384. </tr>
  3385. </table>
  3386. </div><div class="memdoc">
  3387. <p>Write data to an open file. Form required by Print.</p>
  3388. <dl class="section note"><dt>Note</dt><dd>Data is moved to the cache but may not be written to the storage device until <a class="el" href="class_fat_file.html#a67f3dc4896c542d695e11aac927f585e">sync()</a> is called.</dd></dl>
  3389. <dl class="params"><dt>Parameters</dt><dd>
  3390. <table class="params">
  3391. <tr><td class="paramdir">[in]</td><td class="paramname">buf</td><td>Pointer to the location of the data to be written.</td></tr>
  3392. <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>Number of bytes to write.</td></tr>
  3393. </table>
  3394. </dd>
  3395. </dl>
  3396. <dl class="section return"><dt>Returns</dt><dd>For success <a class="el" href="class_file.html#a618a6b2b7e81bfb93e0d3c158f614f90">write()</a> returns the number of bytes written, always <em>nbyte</em>. If an error occurs, <a class="el" href="class_file.html#a618a6b2b7e81bfb93e0d3c158f614f90">write()</a> returns -1. Possible errors include <a class="el" href="class_file.html#a618a6b2b7e81bfb93e0d3c158f614f90">write()</a> is called before a file has been opened, write is called for a read-only file, device is full, a corrupt file system or an I/O error. </dd></dl>
  3397. </div>
  3398. </div>
  3399. <a class="anchor" id="aa4a5b81161994cea07938702cdfce49f"></a>
  3400. <div class="memitem">
  3401. <div class="memproto">
  3402. <table class="mlabels">
  3403. <tr>
  3404. <td class="mlabels-left">
  3405. <table class="memname">
  3406. <tr>
  3407. <td class="memname">int FatFile::write </td>
  3408. <td>(</td>
  3409. <td class="paramtype">const char *&#160;</td>
  3410. <td class="paramname"><em>str</em></td><td>)</td>
  3411. <td></td>
  3412. </tr>
  3413. </table>
  3414. </td>
  3415. <td class="mlabels-right">
  3416. <span class="mlabels"><span class="mlabel">inline</span><span class="mlabel">inherited</span></span> </td>
  3417. </tr>
  3418. </table>
  3419. </div><div class="memdoc">
  3420. <p>Write a string to a file. Used by the Arduino Print class. </p><dl class="params"><dt>Parameters</dt><dd>
  3421. <table class="params">
  3422. <tr><td class="paramdir">[in]</td><td class="paramname">str</td><td>Pointer to the string. Use getWriteError to check for errors. </td></tr>
  3423. </table>
  3424. </dd>
  3425. </dl>
  3426. <dl class="section return"><dt>Returns</dt><dd>count of characters written for success or -1 for failure. </dd></dl>
  3427. </div>
  3428. </div>
  3429. <a class="anchor" id="a0ab9df44a9ee4b6eb0a78f15f1e30004"></a>
  3430. <div class="memitem">
  3431. <div class="memproto">
  3432. <table class="mlabels">
  3433. <tr>
  3434. <td class="mlabels-left">
  3435. <table class="memname">
  3436. <tr>
  3437. <td class="memname">int FatFile::write </td>
  3438. <td>(</td>
  3439. <td class="paramtype">const void *&#160;</td>
  3440. <td class="paramname"><em>buf</em>, </td>
  3441. </tr>
  3442. <tr>
  3443. <td class="paramkey"></td>
  3444. <td></td>
  3445. <td class="paramtype">size_t&#160;</td>
  3446. <td class="paramname"><em>nbyte</em>&#160;</td>
  3447. </tr>
  3448. <tr>
  3449. <td></td>
  3450. <td>)</td>
  3451. <td></td><td></td>
  3452. </tr>
  3453. </table>
  3454. </td>
  3455. <td class="mlabels-right">
  3456. <span class="mlabels"><span class="mlabel">inherited</span></span> </td>
  3457. </tr>
  3458. </table>
  3459. </div><div class="memdoc">
  3460. <p>Write data to an open file.</p>
  3461. <dl class="section note"><dt>Note</dt><dd>Data is moved to the cache but may not be written to the storage device until <a class="el" href="class_fat_file.html#a67f3dc4896c542d695e11aac927f585e">sync()</a> is called.</dd></dl>
  3462. <dl class="params"><dt>Parameters</dt><dd>
  3463. <table class="params">
  3464. <tr><td class="paramdir">[in]</td><td class="paramname">buf</td><td>Pointer to the location of the data to be written.</td></tr>
  3465. <tr><td class="paramdir">[in]</td><td class="paramname">nbyte</td><td>Number of bytes to write.</td></tr>
  3466. </table>
  3467. </dd>
  3468. </dl>
  3469. <dl class="section return"><dt>Returns</dt><dd>For success <a class="el" href="class_fat_file.html#aa4a5b81161994cea07938702cdfce49f">write()</a> returns the number of bytes written, always <em>nbyte</em>. If an error occurs, <a class="el" href="class_fat_file.html#aa4a5b81161994cea07938702cdfce49f">write()</a> returns -1. Possible errors include <a class="el" href="class_fat_file.html#aa4a5b81161994cea07938702cdfce49f">write()</a> is called before a file has been opened, write is called for a read-only file, device is full, a corrupt file system or an I/O error. </dd></dl>
  3470. </div>
  3471. </div>
  3472. <hr/>The documentation for this class was generated from the following file:<ul>
  3473. <li>Arduino/libraries/SdFat/src/FatLib/<a class="el" href="_arduino_files_8h.html">ArduinoFiles.h</a></li>
  3474. </ul>
  3475. </div><!-- contents -->
  3476. <!-- start footer part -->
  3477. <hr class="footer"/><address class="footer"><small>
  3478. Generated on Mon Sep 5 2016 10:18:52 for SdFat by &#160;<a href="http://www.doxygen.org/index.html">
  3479. <img class="footer" src="doxygen.png" alt="doxygen"/>
  3480. </a> 1.8.10
  3481. </small></address>
  3482. </body>
  3483. </html>