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

2353 lines
107KB

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://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.16"/>
  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
  8. <title>SdFat: ExFatFile Class Reference</title>
  9. <link href="tabs.css" rel="stylesheet" type="text/css"/>
  10. <script type="text/javascript" src="jquery.js"></script>
  11. <script type="text/javascript" src="dynsections.js"></script>
  12. <link href="search/search.css" rel="stylesheet" type="text/css"/>
  13. <script type="text/javascript" src="search/searchdata.js"></script>
  14. <script type="text/javascript" src="search/search.js"></script>
  15. <link href="doxygen.css" rel="stylesheet" type="text/css" />
  16. </head>
  17. <body>
  18. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  19. <div id="titlearea">
  20. <table cellspacing="0" cellpadding="0">
  21. <tbody>
  22. <tr style="height: 56px;">
  23. <td id="projectalign" style="padding-left: 0.5em;">
  24. <div id="projectname">SdFat
  25. </div>
  26. </td>
  27. </tr>
  28. </tbody>
  29. </table>
  30. </div>
  31. <!-- end header part -->
  32. <!-- Generated by Doxygen 1.8.16 -->
  33. <script type="text/javascript">
  34. /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
  35. var searchBox = new SearchBox("searchBox", "search",false,'Search');
  36. /* @license-end */
  37. </script>
  38. <script type="text/javascript" src="menudata.js"></script>
  39. <script type="text/javascript" src="menu.js"></script>
  40. <script type="text/javascript">
  41. /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
  42. $(function() {
  43. initMenu('',true,false,'search.php','Search');
  44. $(document).ready(function() { init_search(); });
  45. });
  46. /* @license-end */</script>
  47. <div id="main-nav"></div>
  48. <!-- window showing the filter options -->
  49. <div id="MSearchSelectWindow"
  50. onmouseover="return searchBox.OnSearchSelectShow()"
  51. onmouseout="return searchBox.OnSearchSelectHide()"
  52. onkeydown="return searchBox.OnSearchSelectKey(event)">
  53. </div>
  54. <!-- iframe showing the search results (closed by default) -->
  55. <div id="MSearchResultsWindow">
  56. <iframe src="javascript:void(0)" frameborder="0"
  57. name="MSearchResults" id="MSearchResults">
  58. </iframe>
  59. </div>
  60. </div><!-- top -->
  61. <div class="header">
  62. <div class="summary">
  63. <a href="#pub-methods">Public Member Functions</a> &#124;
  64. <a href="#friends">Friends</a> &#124;
  65. <a href="class_ex_fat_file-members.html">List of all members</a> </div>
  66. <div class="headertitle">
  67. <div class="title">ExFatFile Class Reference</div> </div>
  68. </div><!--header-->
  69. <div class="contents">
  70. <p>Basic file class.
  71. <a href="class_ex_fat_file.html#details">More...</a></p>
  72. <p><code>#include &lt;ExFatFile.h&gt;</code></p>
  73. <div class="dynheader">
  74. Inheritance diagram for ExFatFile:</div>
  75. <div class="dyncontent">
  76. <div class="center"><img src="class_ex_fat_file__inherit__graph.png" border="0" usemap="#_ex_fat_file_inherit__map" alt="Inheritance graph"/></div>
  77. <map name="_ex_fat_file_inherit__map" id="_ex_fat_file_inherit__map">
  78. <area shape="rect" title="Basic file class." alt="" coords="45,5,123,32"/>
  79. <area shape="rect" href="class_stream_file.html" title=" " alt="" coords="5,80,163,121"/>
  80. <area shape="rect" href="class_ex_file.html" title="exFAT file with Arduino Stream." alt="" coords="55,169,113,196"/>
  81. </map>
  82. <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
  83. <table class="memberdecls">
  84. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
  85. Public Member Functions</h2></td></tr>
  86. <tr class="memitem:a1eae02704b69e903ea174c5d0744debb"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a1eae02704b69e903ea174c5d0744debb">available</a> ()</td></tr>
  87. <tr class="separator:a1eae02704b69e903ea174c5d0744debb"><td class="memSeparator" colspan="2">&#160;</td></tr>
  88. <tr class="memitem:adcf47e15b819fe2d6faac2a027ab30f5"><td class="memItemLeft" align="right" valign="top">uint64_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#adcf47e15b819fe2d6faac2a027ab30f5">available64</a> ()</td></tr>
  89. <tr class="separator:adcf47e15b819fe2d6faac2a027ab30f5"><td class="memSeparator" colspan="2">&#160;</td></tr>
  90. <tr class="memitem:ac2004e7bf328b3edda7d4c3acba2726f"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ac2004e7bf328b3edda7d4c3acba2726f">clearError</a> ()</td></tr>
  91. <tr class="separator:ac2004e7bf328b3edda7d4c3acba2726f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  92. <tr class="memitem:abc0d3863895c17df53930bdfa84cb06f"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#abc0d3863895c17df53930bdfa84cb06f">clearWriteError</a> ()</td></tr>
  93. <tr class="separator:abc0d3863895c17df53930bdfa84cb06f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  94. <tr class="memitem:a7ba9e04099bdf8fd34220ebfdde72867"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a7ba9e04099bdf8fd34220ebfdde72867">close</a> ()</td></tr>
  95. <tr class="separator:a7ba9e04099bdf8fd34220ebfdde72867"><td class="memSeparator" colspan="2">&#160;</td></tr>
  96. <tr class="memitem:ab49396aad3f6500aa19f75490dc26719"><td class="memItemLeft" align="right" valign="top">uint64_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ab49396aad3f6500aa19f75490dc26719">curPosition</a> () const</td></tr>
  97. <tr class="separator:ab49396aad3f6500aa19f75490dc26719"><td class="memSeparator" colspan="2">&#160;</td></tr>
  98. <tr class="memitem:ada4dde9f2eed36bf556fcf1bd3d28ccf"><td class="memItemLeft" align="right" valign="top">uint64_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ada4dde9f2eed36bf556fcf1bd3d28ccf">dataLength</a> ()</td></tr>
  99. <tr class="separator:ada4dde9f2eed36bf556fcf1bd3d28ccf"><td class="memSeparator" colspan="2">&#160;</td></tr>
  100. <tr class="memitem:a5e3baa5d5269c2948cfaf604c42f6a16"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a5e3baa5d5269c2948cfaf604c42f6a16">dirIndex</a> ()</td></tr>
  101. <tr class="separator:a5e3baa5d5269c2948cfaf604c42f6a16"><td class="memSeparator" colspan="2">&#160;</td></tr>
  102. <tr class="memitem:a3c1303c37cad370b33f0279524c93720"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a3c1303c37cad370b33f0279524c93720">ExFatFile</a> ()</td></tr>
  103. <tr class="separator:a3c1303c37cad370b33f0279524c93720"><td class="memSeparator" colspan="2">&#160;</td></tr>
  104. <tr class="memitem:a22a717ddc6d2004c540c67a14264d9dd"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a22a717ddc6d2004c540c67a14264d9dd">exists</a> (const ExChar_t *path)</td></tr>
  105. <tr class="separator:a22a717ddc6d2004c540c67a14264d9dd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  106. <tr class="memitem:a8614bcbf04b7bbfc70fe36d2fa7f70c1"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a8614bcbf04b7bbfc70fe36d2fa7f70c1">fgetpos</a> (fspos_t *pos)</td></tr>
  107. <tr class="separator:a8614bcbf04b7bbfc70fe36d2fa7f70c1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  108. <tr class="memitem:abc69c9dfc8fdb4ebf9db3bc37c879dc6"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#abc69c9dfc8fdb4ebf9db3bc37c879dc6">fgets</a> (char *str, int num, char *delim=<a class="el" href="_stdio_stream_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a>)</td></tr>
  109. <tr class="separator:abc69c9dfc8fdb4ebf9db3bc37c879dc6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  110. <tr class="memitem:af2c08909b62b01f3edc4ee0c51ea7435"><td class="memItemLeft" align="right" valign="top">uint64_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#af2c08909b62b01f3edc4ee0c51ea7435">fileSize</a> ()</td></tr>
  111. <tr class="separator:af2c08909b62b01f3edc4ee0c51ea7435"><td class="memSeparator" colspan="2">&#160;</td></tr>
  112. <tr class="memitem:ab16f38103a13394bffd8aa5be830c4fe"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ab16f38103a13394bffd8aa5be830c4fe">flush</a> ()</td></tr>
  113. <tr class="separator:ab16f38103a13394bffd8aa5be830c4fe"><td class="memSeparator" colspan="2">&#160;</td></tr>
  114. <tr class="memitem:aea1e4d0c0981081774dc3c7cd3c55264"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#aea1e4d0c0981081774dc3c7cd3c55264">fsetpos</a> (const fspos_t *pos)</td></tr>
  115. <tr class="separator:aea1e4d0c0981081774dc3c7cd3c55264"><td class="memSeparator" colspan="2">&#160;</td></tr>
  116. <tr class="memitem:ac697224450ca216c60585d25f5f6e310"><td class="memItemLeft" align="right" valign="top">uint8_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ac697224450ca216c60585d25f5f6e310">getError</a> ()</td></tr>
  117. <tr class="separator:ac697224450ca216c60585d25f5f6e310"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <tr class="memitem:aba93e2c18be9fa4df7e067b7d6ac5906"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#aba93e2c18be9fa4df7e067b7d6ac5906">getName</a> (ExChar_t *name, size_t size)</td></tr>
  119. <tr class="separator:aba93e2c18be9fa4df7e067b7d6ac5906"><td class="memSeparator" colspan="2">&#160;</td></tr>
  120. <tr class="memitem:a01da9896a59671a61f90dd20c3ac5d07"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a01da9896a59671a61f90dd20c3ac5d07">getWriteError</a> ()</td></tr>
  121. <tr class="separator:a01da9896a59671a61f90dd20c3ac5d07"><td class="memSeparator" colspan="2">&#160;</td></tr>
  122. <tr class="memitem:a7a167102bd47b7cf91167b69f8cc57d1"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a7a167102bd47b7cf91167b69f8cc57d1">isContiguous</a> () const</td></tr>
  123. <tr class="separator:a7a167102bd47b7cf91167b69f8cc57d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
  124. <tr class="memitem:ad0a3687bd95bed5b216651335e66b500"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ad0a3687bd95bed5b216651335e66b500">isDir</a> () const</td></tr>
  125. <tr class="separator:ad0a3687bd95bed5b216651335e66b500"><td class="memSeparator" colspan="2">&#160;</td></tr>
  126. <tr class="memitem:af601285f95db8398c140b3927cf9111c"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#af601285f95db8398c140b3927cf9111c">isFile</a> () const</td></tr>
  127. <tr class="separator:af601285f95db8398c140b3927cf9111c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  128. <tr class="memitem:ac926285fa4321ebee28fa91beb511eae"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ac926285fa4321ebee28fa91beb511eae">isHidden</a> () const</td></tr>
  129. <tr class="separator:ac926285fa4321ebee28fa91beb511eae"><td class="memSeparator" colspan="2">&#160;</td></tr>
  130. <tr class="memitem:a804c34bbe3ebefe2b6c1d77ff8d49a35"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a804c34bbe3ebefe2b6c1d77ff8d49a35">isOpen</a> () const</td></tr>
  131. <tr class="separator:a804c34bbe3ebefe2b6c1d77ff8d49a35"><td class="memSeparator" colspan="2">&#160;</td></tr>
  132. <tr class="memitem:a9ca137dfba2c7772910f4d2b3fdd9411"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a9ca137dfba2c7772910f4d2b3fdd9411">isReadable</a> () const</td></tr>
  133. <tr class="separator:a9ca137dfba2c7772910f4d2b3fdd9411"><td class="memSeparator" colspan="2">&#160;</td></tr>
  134. <tr class="memitem:a14d160bfbfb39717746b93fa2eda5739"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a14d160bfbfb39717746b93fa2eda5739">isReadOnly</a> () const</td></tr>
  135. <tr class="separator:a14d160bfbfb39717746b93fa2eda5739"><td class="memSeparator" colspan="2">&#160;</td></tr>
  136. <tr class="memitem:ad9f8e7afcf749ebcaaf055bd569dc7da"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ad9f8e7afcf749ebcaaf055bd569dc7da">isRoot</a> () const</td></tr>
  137. <tr class="separator:ad9f8e7afcf749ebcaaf055bd569dc7da"><td class="memSeparator" colspan="2">&#160;</td></tr>
  138. <tr class="memitem:ad7e02a1db8fb5a90288bb4679e9ddcb9"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ad7e02a1db8fb5a90288bb4679e9ddcb9">isSubDir</a> () const</td></tr>
  139. <tr class="separator:ad7e02a1db8fb5a90288bb4679e9ddcb9"><td class="memSeparator" colspan="2">&#160;</td></tr>
  140. <tr class="memitem:a04d1c43e80743f8c1a51b64062ce16dd"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a04d1c43e80743f8c1a51b64062ce16dd">isWritable</a> () const</td></tr>
  141. <tr class="separator:a04d1c43e80743f8c1a51b64062ce16dd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  142. <tr class="memitem:aa0e074c891f3db5ea2ebd491667b03a6"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#aa0e074c891f3db5ea2ebd491667b03a6">ls</a> (<a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  143. <tr class="separator:aa0e074c891f3db5ea2ebd491667b03a6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  144. <tr class="memitem:a09f8beb55f939874e93c1df6c8a046d4"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a09f8beb55f939874e93c1df6c8a046d4">ls</a> (<a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr, uint8_t flags, uint8_t indent=0)</td></tr>
  145. <tr class="separator:a09f8beb55f939874e93c1df6c8a046d4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  146. <tr class="memitem:a3a393624d52854e74bf385c9e513a86d"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a3a393624d52854e74bf385c9e513a86d">mkdir</a> (<a class="el" href="class_ex_fat_file.html">ExFatFile</a> *parent, const ExChar_t *path, bool pFlag=true)</td></tr>
  147. <tr class="separator:a3a393624d52854e74bf385c9e513a86d"><td class="memSeparator" colspan="2">&#160;</td></tr>
  148. <tr class="memitem:ab1e224aba9eb796c7ad48062cc1434c2"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ab1e224aba9eb796c7ad48062cc1434c2">open</a> (const ExChar_t *path, int oflag=0X00)</td></tr>
  149. <tr class="separator:ab1e224aba9eb796c7ad48062cc1434c2"><td class="memSeparator" colspan="2">&#160;</td></tr>
  150. <tr class="memitem:ad0be05c5c7092317089872778052cbd7"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ad0be05c5c7092317089872778052cbd7">open</a> (<a class="el" href="class_ex_fat_file.html">ExFatFile</a> *dirFile, const ExChar_t *path, oflag_t oflag)</td></tr>
  151. <tr class="separator:ad0be05c5c7092317089872778052cbd7"><td class="memSeparator" colspan="2">&#160;</td></tr>
  152. <tr class="memitem:a414b64dc30551e05dcc46f04e0f6413a"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a414b64dc30551e05dcc46f04e0f6413a">open</a> (<a class="el" href="class_ex_fat_file.html">ExFatFile</a> *dirFile, uint32_t index, oflag_t oflag)</td></tr>
  153. <tr class="separator:a414b64dc30551e05dcc46f04e0f6413a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  154. <tr class="memitem:a825447643e6c9e8284a3ed78e3363788"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a825447643e6c9e8284a3ed78e3363788">open</a> (<a class="el" href="class_ex_fat_volume.html">ExFatVolume</a> *vol, const ExChar_t *path, int oflag)</td></tr>
  155. <tr class="separator:a825447643e6c9e8284a3ed78e3363788"><td class="memSeparator" colspan="2">&#160;</td></tr>
  156. <tr class="memitem:a89b6021cf70b7adb9feb162260d5a101"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a89b6021cf70b7adb9feb162260d5a101">openNext</a> (<a class="el" href="class_ex_fat_file.html">ExFatFile</a> *dirFile, oflag_t oflag=0X00)</td></tr>
  157. <tr class="separator:a89b6021cf70b7adb9feb162260d5a101"><td class="memSeparator" colspan="2">&#160;</td></tr>
  158. <tr class="memitem:af664c1da1bfa0bb5f6eb933bc25f757e"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#af664c1da1bfa0bb5f6eb933bc25f757e">openRoot</a> (<a class="el" href="class_ex_fat_volume.html">ExFatVolume</a> *vol)</td></tr>
  159. <tr class="separator:af664c1da1bfa0bb5f6eb933bc25f757e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  160. <tr class="memitem:aa1abbd813f27d488f0ff439ccbc9ca98"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#aa1abbd813f27d488f0ff439ccbc9ca98">operator bool</a> ()</td></tr>
  161. <tr class="separator:aa1abbd813f27d488f0ff439ccbc9ca98"><td class="memSeparator" colspan="2">&#160;</td></tr>
  162. <tr class="memitem:afc2e375faa696545f7ebbf583faae72a"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#afc2e375faa696545f7ebbf583faae72a">peek</a> ()</td></tr>
  163. <tr class="separator:afc2e375faa696545f7ebbf583faae72a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  164. <tr class="memitem:a35a5093014e80965e49c84b61780556f"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a35a5093014e80965e49c84b61780556f">preAllocate</a> (uint64_t length)</td></tr>
  165. <tr class="separator:a35a5093014e80965e49c84b61780556f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  166. <tr class="memitem:ad9ba8aa00b9db683d40fc2989dbe1922"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ad9ba8aa00b9db683d40fc2989dbe1922">printAccessDateTime</a> (<a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  167. <tr class="separator:ad9ba8aa00b9db683d40fc2989dbe1922"><td class="memSeparator" colspan="2">&#160;</td></tr>
  168. <tr class="memitem:a7318b2d7594d6ba52421c413f5fc35cd"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a7318b2d7594d6ba52421c413f5fc35cd">printCreateDateTime</a> (<a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  169. <tr class="separator:a7318b2d7594d6ba52421c413f5fc35cd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  170. <tr class="memitem:a496ac61e367a24665425d54956a46346"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a496ac61e367a24665425d54956a46346">printField</a> (double value, char term, uint8_t prec=2)</td></tr>
  171. <tr class="separator:a496ac61e367a24665425d54956a46346"><td class="memSeparator" colspan="2">&#160;</td></tr>
  172. <tr class="memitem:a70eda4191df90f608694c1faede7fb33"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a70eda4191df90f608694c1faede7fb33">printField</a> (float value, char term, uint8_t prec=2)</td></tr>
  173. <tr class="separator:a70eda4191df90f608694c1faede7fb33"><td class="memSeparator" colspan="2">&#160;</td></tr>
  174. <tr class="memitem:a9759c13e804c01ff9e7e2ac8fbabc5b8"><td class="memTemplParams" colspan="2">template&lt;typename Type &gt; </td></tr>
  175. <tr class="memitem:a9759c13e804c01ff9e7e2ac8fbabc5b8"><td class="memTemplItemLeft" align="right" valign="top">size_t&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a9759c13e804c01ff9e7e2ac8fbabc5b8">printField</a> (Type value, char term)</td></tr>
  176. <tr class="separator:a9759c13e804c01ff9e7e2ac8fbabc5b8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  177. <tr class="memitem:a16d527f98cff3ffd3ba8bc594a22d186"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a16d527f98cff3ffd3ba8bc594a22d186">printFileSize</a> (<a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  178. <tr class="separator:a16d527f98cff3ffd3ba8bc594a22d186"><td class="memSeparator" colspan="2">&#160;</td></tr>
  179. <tr class="memitem:a16488d3e0d946f108240b7d6c536c6f4"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a16488d3e0d946f108240b7d6c536c6f4">printModifyDateTime</a> (<a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  180. <tr class="separator:a16488d3e0d946f108240b7d6c536c6f4"><td class="memSeparator" colspan="2">&#160;</td></tr>
  181. <tr class="memitem:a095c0a865e5e5b6463c3dc0c90680635"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a095c0a865e5e5b6463c3dc0c90680635">printName</a> (<a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *pr)</td></tr>
  182. <tr class="separator:a095c0a865e5e5b6463c3dc0c90680635"><td class="memSeparator" colspan="2">&#160;</td></tr>
  183. <tr class="memitem:a77f4fea0aae0c8bae926fdfbba260a55"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a77f4fea0aae0c8bae926fdfbba260a55">read</a> ()</td></tr>
  184. <tr class="separator:a77f4fea0aae0c8bae926fdfbba260a55"><td class="memSeparator" colspan="2">&#160;</td></tr>
  185. <tr class="memitem:a5ae5477efe55179cf07e173c62654313"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a5ae5477efe55179cf07e173c62654313">read</a> (void *buf, size_t count)</td></tr>
  186. <tr class="separator:a5ae5477efe55179cf07e173c62654313"><td class="memSeparator" colspan="2">&#160;</td></tr>
  187. <tr class="memitem:a8e88c8e79551a72cc98310038514c47a"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a8e88c8e79551a72cc98310038514c47a">remove</a> ()</td></tr>
  188. <tr class="separator:a8e88c8e79551a72cc98310038514c47a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  189. <tr class="memitem:ad10417a851dba3d40a78eb2c0eb11fff"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ad10417a851dba3d40a78eb2c0eb11fff">remove</a> (const ExChar_t *path)</td></tr>
  190. <tr class="separator:ad10417a851dba3d40a78eb2c0eb11fff"><td class="memSeparator" colspan="2">&#160;</td></tr>
  191. <tr class="memitem:aab50b2646035f76834c75230d2b55c64"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#aab50b2646035f76834c75230d2b55c64">rename</a> (const ExChar_t *newPath)</td></tr>
  192. <tr class="separator:aab50b2646035f76834c75230d2b55c64"><td class="memSeparator" colspan="2">&#160;</td></tr>
  193. <tr class="memitem:aea570a3b6afbe633d874803b137a46b8"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#aea570a3b6afbe633d874803b137a46b8">rename</a> (<a class="el" href="class_ex_fat_file.html">ExFatFile</a> *dirFile, const ExChar_t *newPath)</td></tr>
  194. <tr class="separator:aea570a3b6afbe633d874803b137a46b8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  195. <tr class="memitem:a3c1d3ef65284ffb13ed3ceee472adf9a"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a3c1d3ef65284ffb13ed3ceee472adf9a">rewind</a> ()</td></tr>
  196. <tr class="separator:a3c1d3ef65284ffb13ed3ceee472adf9a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  197. <tr class="memitem:a0165e0fde12a53e419bd92cd37f9cfed"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a0165e0fde12a53e419bd92cd37f9cfed">rmdir</a> ()</td></tr>
  198. <tr class="separator:a0165e0fde12a53e419bd92cd37f9cfed"><td class="memSeparator" colspan="2">&#160;</td></tr>
  199. <tr class="memitem:ab42494880cf229adfb0fc8edb0647686"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#ab42494880cf229adfb0fc8edb0647686">seekCur</a> (int64_t offset)</td></tr>
  200. <tr class="separator:ab42494880cf229adfb0fc8edb0647686"><td class="memSeparator" colspan="2">&#160;</td></tr>
  201. <tr class="memitem:a2994a71751ed4f137f48b2e9a7d94091"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a2994a71751ed4f137f48b2e9a7d94091">seekEnd</a> (int64_t offset=0)</td></tr>
  202. <tr class="separator:a2994a71751ed4f137f48b2e9a7d94091"><td class="memSeparator" colspan="2">&#160;</td></tr>
  203. <tr class="memitem:a9834c4da2f14c66f4bda26938ebb36f6"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a9834c4da2f14c66f4bda26938ebb36f6">seekSet</a> (uint64_t pos)</td></tr>
  204. <tr class="separator:a9834c4da2f14c66f4bda26938ebb36f6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  205. <tr class="memitem:a2cb3638069afd2d01b79e5dff1a66f55"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a2cb3638069afd2d01b79e5dff1a66f55">sync</a> ()</td></tr>
  206. <tr class="separator:a2cb3638069afd2d01b79e5dff1a66f55"><td class="memSeparator" colspan="2">&#160;</td></tr>
  207. <tr class="memitem:a6d3ab10983e206401ebd5c24a1c46174"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a6d3ab10983e206401ebd5c24a1c46174">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>
  208. <tr class="separator:a6d3ab10983e206401ebd5c24a1c46174"><td class="memSeparator" colspan="2">&#160;</td></tr>
  209. <tr class="memitem:aca37955d3c7cce40f7f9e1ea078e5636"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#aca37955d3c7cce40f7f9e1ea078e5636">truncate</a> ()</td></tr>
  210. <tr class="separator:aca37955d3c7cce40f7f9e1ea078e5636"><td class="memSeparator" colspan="2">&#160;</td></tr>
  211. <tr class="memitem:a6262b0d6d43d2a426953a0a7d90f624f"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a6262b0d6d43d2a426953a0a7d90f624f">truncate</a> (uint64_t length)</td></tr>
  212. <tr class="separator:a6262b0d6d43d2a426953a0a7d90f624f"><td class="memSeparator" colspan="2">&#160;</td></tr>
  213. <tr class="memitem:afc8af11ba8e3a830dff1dd5e59446243"><td class="memItemLeft" align="right" valign="top">uint64_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#afc8af11ba8e3a830dff1dd5e59446243">validLength</a> ()</td></tr>
  214. <tr class="separator:afc8af11ba8e3a830dff1dd5e59446243"><td class="memSeparator" colspan="2">&#160;</td></tr>
  215. <tr class="memitem:a6fb2905a5e363554a5118b5d1322cd87"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a6fb2905a5e363554a5118b5d1322cd87">write</a> (const char *str)</td></tr>
  216. <tr class="separator:a6fb2905a5e363554a5118b5d1322cd87"><td class="memSeparator" colspan="2">&#160;</td></tr>
  217. <tr class="memitem:abc1423c7b550614d1067e7173f8b46a8"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#abc1423c7b550614d1067e7173f8b46a8">write</a> (const void *buf, size_t count)</td></tr>
  218. <tr class="separator:abc1423c7b550614d1067e7173f8b46a8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  219. <tr class="memitem:afd011d17d66707623c28927a63f81015"><td class="memItemLeft" align="right" valign="top">size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#afd011d17d66707623c28927a63f81015">write</a> (uint8_t b)</td></tr>
  220. <tr class="separator:afd011d17d66707623c28927a63f81015"><td class="memSeparator" colspan="2">&#160;</td></tr>
  221. </table><table class="memberdecls">
  222. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="friends"></a>
  223. Friends</h2></td></tr>
  224. <tr class="memitem:a064869383f7639b113eb0aaf0b84335c"><td class="memItemLeft" align="right" valign="top">class&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_ex_fat_file.html#a064869383f7639b113eb0aaf0b84335c">ExFatVolume</a></td></tr>
  225. <tr class="separator:a064869383f7639b113eb0aaf0b84335c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  226. </table>
  227. <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
  228. <div class="textblock"><p>Basic file class. </p>
  229. </div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  230. <a id="a3c1303c37cad370b33f0279524c93720"></a>
  231. <h2 class="memtitle"><span class="permalink"><a href="#a3c1303c37cad370b33f0279524c93720">&#9670;&nbsp;</a></span>ExFatFile()</h2>
  232. <div class="memitem">
  233. <div class="memproto">
  234. <table class="mlabels">
  235. <tr>
  236. <td class="mlabels-left">
  237. <table class="memname">
  238. <tr>
  239. <td class="memname">ExFatFile::ExFatFile </td>
  240. <td>(</td>
  241. <td class="paramname"></td><td>)</td>
  242. <td></td>
  243. </tr>
  244. </table>
  245. </td>
  246. <td class="mlabels-right">
  247. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  248. </tr>
  249. </table>
  250. </div><div class="memdoc">
  251. <p>Create an instance. </p>
  252. </div>
  253. </div>
  254. <h2 class="groupheader">Member Function Documentation</h2>
  255. <a id="a1eae02704b69e903ea174c5d0744debb"></a>
  256. <h2 class="memtitle"><span class="permalink"><a href="#a1eae02704b69e903ea174c5d0744debb">&#9670;&nbsp;</a></span>available()</h2>
  257. <div class="memitem">
  258. <div class="memproto">
  259. <table class="mlabels">
  260. <tr>
  261. <td class="mlabels-left">
  262. <table class="memname">
  263. <tr>
  264. <td class="memname">int ExFatFile::available </td>
  265. <td>(</td>
  266. <td class="paramname"></td><td>)</td>
  267. <td></td>
  268. </tr>
  269. </table>
  270. </td>
  271. <td class="mlabels-right">
  272. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  273. </tr>
  274. </table>
  275. </div><div class="memdoc">
  276. <dl class="section return"><dt>Returns</dt><dd>The number of bytes available from the current position to EOF for normal files. INT_MAX is returned for very large files.</dd></dl>
  277. <p><a class="el" href="class_ex_fat_file.html#adcf47e15b819fe2d6faac2a027ab30f5">available64()</a> is recomended for very large files.</p>
  278. <p>Zero is returned for directory files. </p>
  279. </div>
  280. </div>
  281. <a id="adcf47e15b819fe2d6faac2a027ab30f5"></a>
  282. <h2 class="memtitle"><span class="permalink"><a href="#adcf47e15b819fe2d6faac2a027ab30f5">&#9670;&nbsp;</a></span>available64()</h2>
  283. <div class="memitem">
  284. <div class="memproto">
  285. <table class="mlabels">
  286. <tr>
  287. <td class="mlabels-left">
  288. <table class="memname">
  289. <tr>
  290. <td class="memname">uint64_t ExFatFile::available64 </td>
  291. <td>(</td>
  292. <td class="paramname"></td><td>)</td>
  293. <td></td>
  294. </tr>
  295. </table>
  296. </td>
  297. <td class="mlabels-right">
  298. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  299. </tr>
  300. </table>
  301. </div><div class="memdoc">
  302. <dl class="section return"><dt>Returns</dt><dd>The number of bytes available from the current position to EOF for normal files. Zero is returned for directory files. </dd></dl>
  303. </div>
  304. </div>
  305. <a id="ac2004e7bf328b3edda7d4c3acba2726f"></a>
  306. <h2 class="memtitle"><span class="permalink"><a href="#ac2004e7bf328b3edda7d4c3acba2726f">&#9670;&nbsp;</a></span>clearError()</h2>
  307. <div class="memitem">
  308. <div class="memproto">
  309. <table class="mlabels">
  310. <tr>
  311. <td class="mlabels-left">
  312. <table class="memname">
  313. <tr>
  314. <td class="memname">void ExFatFile::clearError </td>
  315. <td>(</td>
  316. <td class="paramname"></td><td>)</td>
  317. <td></td>
  318. </tr>
  319. </table>
  320. </td>
  321. <td class="mlabels-right">
  322. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  323. </tr>
  324. </table>
  325. </div><div class="memdoc">
  326. <p>Clear all error bits. </p>
  327. </div>
  328. </div>
  329. <a id="abc0d3863895c17df53930bdfa84cb06f"></a>
  330. <h2 class="memtitle"><span class="permalink"><a href="#abc0d3863895c17df53930bdfa84cb06f">&#9670;&nbsp;</a></span>clearWriteError()</h2>
  331. <div class="memitem">
  332. <div class="memproto">
  333. <table class="mlabels">
  334. <tr>
  335. <td class="mlabels-left">
  336. <table class="memname">
  337. <tr>
  338. <td class="memname">void ExFatFile::clearWriteError </td>
  339. <td>(</td>
  340. <td class="paramname"></td><td>)</td>
  341. <td></td>
  342. </tr>
  343. </table>
  344. </td>
  345. <td class="mlabels-right">
  346. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  347. </tr>
  348. </table>
  349. </div><div class="memdoc">
  350. <p>Set writeError to zero </p>
  351. </div>
  352. </div>
  353. <a id="a7ba9e04099bdf8fd34220ebfdde72867"></a>
  354. <h2 class="memtitle"><span class="permalink"><a href="#a7ba9e04099bdf8fd34220ebfdde72867">&#9670;&nbsp;</a></span>close()</h2>
  355. <div class="memitem">
  356. <div class="memproto">
  357. <table class="memname">
  358. <tr>
  359. <td class="memname">bool ExFatFile::close </td>
  360. <td>(</td>
  361. <td class="paramname"></td><td>)</td>
  362. <td></td>
  363. </tr>
  364. </table>
  365. </div><div class="memdoc">
  366. <p>Close a file and force cached data and directory information to be written to the storage device.</p>
  367. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  368. </div>
  369. </div>
  370. <a id="ab49396aad3f6500aa19f75490dc26719"></a>
  371. <h2 class="memtitle"><span class="permalink"><a href="#ab49396aad3f6500aa19f75490dc26719">&#9670;&nbsp;</a></span>curPosition()</h2>
  372. <div class="memitem">
  373. <div class="memproto">
  374. <table class="mlabels">
  375. <tr>
  376. <td class="mlabels-left">
  377. <table class="memname">
  378. <tr>
  379. <td class="memname">uint64_t ExFatFile::curPosition </td>
  380. <td>(</td>
  381. <td class="paramname"></td><td>)</td>
  382. <td> const</td>
  383. </tr>
  384. </table>
  385. </td>
  386. <td class="mlabels-right">
  387. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  388. </tr>
  389. </table>
  390. </div><div class="memdoc">
  391. <dl class="section return"><dt>Returns</dt><dd>The current position for a file or directory. </dd></dl>
  392. </div>
  393. </div>
  394. <a id="ada4dde9f2eed36bf556fcf1bd3d28ccf"></a>
  395. <h2 class="memtitle"><span class="permalink"><a href="#ada4dde9f2eed36bf556fcf1bd3d28ccf">&#9670;&nbsp;</a></span>dataLength()</h2>
  396. <div class="memitem">
  397. <div class="memproto">
  398. <table class="mlabels">
  399. <tr>
  400. <td class="mlabels-left">
  401. <table class="memname">
  402. <tr>
  403. <td class="memname">uint64_t ExFatFile::dataLength </td>
  404. <td>(</td>
  405. <td class="paramname"></td><td>)</td>
  406. <td></td>
  407. </tr>
  408. </table>
  409. </td>
  410. <td class="mlabels-right">
  411. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  412. </tr>
  413. </table>
  414. </div><div class="memdoc">
  415. <dl class="section return"><dt>Returns</dt><dd>Total data length for file. </dd></dl>
  416. </div>
  417. </div>
  418. <a id="a5e3baa5d5269c2948cfaf604c42f6a16"></a>
  419. <h2 class="memtitle"><span class="permalink"><a href="#a5e3baa5d5269c2948cfaf604c42f6a16">&#9670;&nbsp;</a></span>dirIndex()</h2>
  420. <div class="memitem">
  421. <div class="memproto">
  422. <table class="mlabels">
  423. <tr>
  424. <td class="mlabels-left">
  425. <table class="memname">
  426. <tr>
  427. <td class="memname">uint32_t ExFatFile::dirIndex </td>
  428. <td>(</td>
  429. <td class="paramname"></td><td>)</td>
  430. <td></td>
  431. </tr>
  432. </table>
  433. </td>
  434. <td class="mlabels-right">
  435. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  436. </tr>
  437. </table>
  438. </div><div class="memdoc">
  439. <dl class="section return"><dt>Returns</dt><dd>Directory entry index. </dd></dl>
  440. </div>
  441. </div>
  442. <a id="a22a717ddc6d2004c540c67a14264d9dd"></a>
  443. <h2 class="memtitle"><span class="permalink"><a href="#a22a717ddc6d2004c540c67a14264d9dd">&#9670;&nbsp;</a></span>exists()</h2>
  444. <div class="memitem">
  445. <div class="memproto">
  446. <table class="mlabels">
  447. <tr>
  448. <td class="mlabels-left">
  449. <table class="memname">
  450. <tr>
  451. <td class="memname">bool ExFatFile::exists </td>
  452. <td>(</td>
  453. <td class="paramtype">const ExChar_t *&#160;</td>
  454. <td class="paramname"><em>path</em></td><td>)</td>
  455. <td></td>
  456. </tr>
  457. </table>
  458. </td>
  459. <td class="mlabels-right">
  460. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  461. </tr>
  462. </table>
  463. </div><div class="memdoc">
  464. <p>Test for the existence of a file in a directory</p>
  465. <dl class="params"><dt>Parameters</dt><dd>
  466. <table class="params">
  467. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>Path of the file to be tested for.</td></tr>
  468. </table>
  469. </dd>
  470. </dl>
  471. <p>The calling instance must be an open directory file.</p>
  472. <p>dirFile.exists("TOFIND.TXT") searches for "TOFIND.TXT" in the directory dirFile.</p>
  473. <dl class="section return"><dt>Returns</dt><dd>true if the file exists else false. </dd></dl>
  474. </div>
  475. </div>
  476. <a id="a8614bcbf04b7bbfc70fe36d2fa7f70c1"></a>
  477. <h2 class="memtitle"><span class="permalink"><a href="#a8614bcbf04b7bbfc70fe36d2fa7f70c1">&#9670;&nbsp;</a></span>fgetpos()</h2>
  478. <div class="memitem">
  479. <div class="memproto">
  480. <table class="memname">
  481. <tr>
  482. <td class="memname">void ExFatFile::fgetpos </td>
  483. <td>(</td>
  484. <td class="paramtype">fspos_t *&#160;</td>
  485. <td class="paramname"><em>pos</em></td><td>)</td>
  486. <td></td>
  487. </tr>
  488. </table>
  489. </div><div class="memdoc">
  490. <p>get position for streams </p><dl class="params"><dt>Parameters</dt><dd>
  491. <table class="params">
  492. <tr><td class="paramdir">[out]</td><td class="paramname">pos</td><td>struct to receive position </td></tr>
  493. </table>
  494. </dd>
  495. </dl>
  496. </div>
  497. </div>
  498. <a id="abc69c9dfc8fdb4ebf9db3bc37c879dc6"></a>
  499. <h2 class="memtitle"><span class="permalink"><a href="#abc69c9dfc8fdb4ebf9db3bc37c879dc6">&#9670;&nbsp;</a></span>fgets()</h2>
  500. <div class="memitem">
  501. <div class="memproto">
  502. <table class="memname">
  503. <tr>
  504. <td class="memname">int ExFatFile::fgets </td>
  505. <td>(</td>
  506. <td class="paramtype">char *&#160;</td>
  507. <td class="paramname"><em>str</em>, </td>
  508. </tr>
  509. <tr>
  510. <td class="paramkey"></td>
  511. <td></td>
  512. <td class="paramtype">int&#160;</td>
  513. <td class="paramname"><em>num</em>, </td>
  514. </tr>
  515. <tr>
  516. <td class="paramkey"></td>
  517. <td></td>
  518. <td class="paramtype">char *&#160;</td>
  519. <td class="paramname"><em>delim</em> = <code><a class="el" href="_stdio_stream_8h.html#a070d2ce7b6bb7e5c05602aa8c308d0c4">NULL</a></code>&#160;</td>
  520. </tr>
  521. <tr>
  522. <td></td>
  523. <td>)</td>
  524. <td></td><td></td>
  525. </tr>
  526. </table>
  527. </div><div class="memdoc">
  528. <p>Get a string from a file.</p>
  529. <p><a class="el" href="class_ex_fat_file.html#abc69c9dfc8fdb4ebf9db3bc37c879dc6">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>
  530. <p><a class="el" href="class_ex_fat_file.html#abc69c9dfc8fdb4ebf9db3bc37c879dc6">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>
  531. <dl class="params"><dt>Parameters</dt><dd>
  532. <table class="params">
  533. <tr><td class="paramdir">[out]</td><td class="paramname">str</td><td>Pointer to the array where the string is stored. </td></tr>
  534. <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>
  535. <tr><td class="paramdir">[in]</td><td class="paramname">delim</td><td>Optional set of delimiters. The default is "\n".</td></tr>
  536. </table>
  537. </dd>
  538. </dl>
  539. <dl class="section return"><dt>Returns</dt><dd>For success <a class="el" href="class_ex_fat_file.html#abc69c9dfc8fdb4ebf9db3bc37c879dc6">fgets()</a> returns the length of the string in <em>str</em>. If no data is read, <a class="el" href="class_ex_fat_file.html#abc69c9dfc8fdb4ebf9db3bc37c879dc6">fgets()</a> returns zero for EOF or -1 if an error occurred. </dd></dl>
  540. </div>
  541. </div>
  542. <a id="af2c08909b62b01f3edc4ee0c51ea7435"></a>
  543. <h2 class="memtitle"><span class="permalink"><a href="#af2c08909b62b01f3edc4ee0c51ea7435">&#9670;&nbsp;</a></span>fileSize()</h2>
  544. <div class="memitem">
  545. <div class="memproto">
  546. <table class="mlabels">
  547. <tr>
  548. <td class="mlabels-left">
  549. <table class="memname">
  550. <tr>
  551. <td class="memname">uint64_t ExFatFile::fileSize </td>
  552. <td>(</td>
  553. <td class="paramname"></td><td>)</td>
  554. <td></td>
  555. </tr>
  556. </table>
  557. </td>
  558. <td class="mlabels-right">
  559. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  560. </tr>
  561. </table>
  562. </div><div class="memdoc">
  563. <dl class="section return"><dt>Returns</dt><dd>The total number of bytes in a file. </dd></dl>
  564. </div>
  565. </div>
  566. <a id="ab16f38103a13394bffd8aa5be830c4fe"></a>
  567. <h2 class="memtitle"><span class="permalink"><a href="#ab16f38103a13394bffd8aa5be830c4fe">&#9670;&nbsp;</a></span>flush()</h2>
  568. <div class="memitem">
  569. <div class="memproto">
  570. <table class="mlabels">
  571. <tr>
  572. <td class="mlabels-left">
  573. <table class="memname">
  574. <tr>
  575. <td class="memname">void ExFatFile::flush </td>
  576. <td>(</td>
  577. <td class="paramname"></td><td>)</td>
  578. <td></td>
  579. </tr>
  580. </table>
  581. </td>
  582. <td class="mlabels-right">
  583. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  584. </tr>
  585. </table>
  586. </div><div class="memdoc">
  587. <p>Arduino name for <a class="el" href="class_ex_fat_file.html#a2cb3638069afd2d01b79e5dff1a66f55">sync()</a> </p>
  588. </div>
  589. </div>
  590. <a id="aea1e4d0c0981081774dc3c7cd3c55264"></a>
  591. <h2 class="memtitle"><span class="permalink"><a href="#aea1e4d0c0981081774dc3c7cd3c55264">&#9670;&nbsp;</a></span>fsetpos()</h2>
  592. <div class="memitem">
  593. <div class="memproto">
  594. <table class="memname">
  595. <tr>
  596. <td class="memname">void ExFatFile::fsetpos </td>
  597. <td>(</td>
  598. <td class="paramtype">const fspos_t *&#160;</td>
  599. <td class="paramname"><em>pos</em></td><td>)</td>
  600. <td></td>
  601. </tr>
  602. </table>
  603. </div><div class="memdoc">
  604. <p>set position for streams </p><dl class="params"><dt>Parameters</dt><dd>
  605. <table class="params">
  606. <tr><td class="paramdir">[in]</td><td class="paramname">pos</td><td>struct with value for new position </td></tr>
  607. </table>
  608. </dd>
  609. </dl>
  610. </div>
  611. </div>
  612. <a id="ac697224450ca216c60585d25f5f6e310"></a>
  613. <h2 class="memtitle"><span class="permalink"><a href="#ac697224450ca216c60585d25f5f6e310">&#9670;&nbsp;</a></span>getError()</h2>
  614. <div class="memitem">
  615. <div class="memproto">
  616. <table class="mlabels">
  617. <tr>
  618. <td class="mlabels-left">
  619. <table class="memname">
  620. <tr>
  621. <td class="memname">uint8_t ExFatFile::getError </td>
  622. <td>(</td>
  623. <td class="paramname"></td><td>)</td>
  624. <td></td>
  625. </tr>
  626. </table>
  627. </td>
  628. <td class="mlabels-right">
  629. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  630. </tr>
  631. </table>
  632. </div><div class="memdoc">
  633. <dl class="section return"><dt>Returns</dt><dd>All error bits. </dd></dl>
  634. </div>
  635. </div>
  636. <a id="aba93e2c18be9fa4df7e067b7d6ac5906"></a>
  637. <h2 class="memtitle"><span class="permalink"><a href="#aba93e2c18be9fa4df7e067b7d6ac5906">&#9670;&nbsp;</a></span>getName()</h2>
  638. <div class="memitem">
  639. <div class="memproto">
  640. <table class="memname">
  641. <tr>
  642. <td class="memname">size_t ExFatFile::getName </td>
  643. <td>(</td>
  644. <td class="paramtype">ExChar_t *&#160;</td>
  645. <td class="paramname"><em>name</em>, </td>
  646. </tr>
  647. <tr>
  648. <td class="paramkey"></td>
  649. <td></td>
  650. <td class="paramtype">size_t&#160;</td>
  651. <td class="paramname"><em>size</em>&#160;</td>
  652. </tr>
  653. <tr>
  654. <td></td>
  655. <td>)</td>
  656. <td></td><td></td>
  657. </tr>
  658. </table>
  659. </div><div class="memdoc">
  660. <p>Get a file's name followed by a zero byte.</p>
  661. <dl class="params"><dt>Parameters</dt><dd>
  662. <table class="params">
  663. <tr><td class="paramdir">[out]</td><td class="paramname">name</td><td>An array of characters for the file's name. </td></tr>
  664. <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The size of the array in characters. </td></tr>
  665. </table>
  666. </dd>
  667. </dl>
  668. <dl class="section return"><dt>Returns</dt><dd>the name length. </dd></dl>
  669. </div>
  670. </div>
  671. <a id="a01da9896a59671a61f90dd20c3ac5d07"></a>
  672. <h2 class="memtitle"><span class="permalink"><a href="#a01da9896a59671a61f90dd20c3ac5d07">&#9670;&nbsp;</a></span>getWriteError()</h2>
  673. <div class="memitem">
  674. <div class="memproto">
  675. <table class="mlabels">
  676. <tr>
  677. <td class="mlabels-left">
  678. <table class="memname">
  679. <tr>
  680. <td class="memname">bool ExFatFile::getWriteError </td>
  681. <td>(</td>
  682. <td class="paramname"></td><td>)</td>
  683. <td></td>
  684. </tr>
  685. </table>
  686. </td>
  687. <td class="mlabels-right">
  688. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  689. </tr>
  690. </table>
  691. </div><div class="memdoc">
  692. <dl class="section return"><dt>Returns</dt><dd>value of writeError </dd></dl>
  693. </div>
  694. </div>
  695. <a id="a7a167102bd47b7cf91167b69f8cc57d1"></a>
  696. <h2 class="memtitle"><span class="permalink"><a href="#a7a167102bd47b7cf91167b69f8cc57d1">&#9670;&nbsp;</a></span>isContiguous()</h2>
  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">bool ExFatFile::isContiguous </td>
  705. <td>(</td>
  706. <td class="paramname"></td><td>)</td>
  707. <td> const</td>
  708. </tr>
  709. </table>
  710. </td>
  711. <td class="mlabels-right">
  712. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  713. </tr>
  714. </table>
  715. </div><div class="memdoc">
  716. <dl class="section return"><dt>Returns</dt><dd>True if the file is contiguous. </dd></dl>
  717. </div>
  718. </div>
  719. <a id="ad0a3687bd95bed5b216651335e66b500"></a>
  720. <h2 class="memtitle"><span class="permalink"><a href="#ad0a3687bd95bed5b216651335e66b500">&#9670;&nbsp;</a></span>isDir()</h2>
  721. <div class="memitem">
  722. <div class="memproto">
  723. <table class="mlabels">
  724. <tr>
  725. <td class="mlabels-left">
  726. <table class="memname">
  727. <tr>
  728. <td class="memname">bool ExFatFile::isDir </td>
  729. <td>(</td>
  730. <td class="paramname"></td><td>)</td>
  731. <td> const</td>
  732. </tr>
  733. </table>
  734. </td>
  735. <td class="mlabels-right">
  736. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  737. </tr>
  738. </table>
  739. </div><div class="memdoc">
  740. <dl class="section return"><dt>Returns</dt><dd>True if this is a directory. </dd></dl>
  741. </div>
  742. </div>
  743. <a id="af601285f95db8398c140b3927cf9111c"></a>
  744. <h2 class="memtitle"><span class="permalink"><a href="#af601285f95db8398c140b3927cf9111c">&#9670;&nbsp;</a></span>isFile()</h2>
  745. <div class="memitem">
  746. <div class="memproto">
  747. <table class="mlabels">
  748. <tr>
  749. <td class="mlabels-left">
  750. <table class="memname">
  751. <tr>
  752. <td class="memname">bool ExFatFile::isFile </td>
  753. <td>(</td>
  754. <td class="paramname"></td><td>)</td>
  755. <td> const</td>
  756. </tr>
  757. </table>
  758. </td>
  759. <td class="mlabels-right">
  760. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  761. </tr>
  762. </table>
  763. </div><div class="memdoc">
  764. <dl class="section return"><dt>Returns</dt><dd>True if this is a normal file. </dd></dl>
  765. </div>
  766. </div>
  767. <a id="ac926285fa4321ebee28fa91beb511eae"></a>
  768. <h2 class="memtitle"><span class="permalink"><a href="#ac926285fa4321ebee28fa91beb511eae">&#9670;&nbsp;</a></span>isHidden()</h2>
  769. <div class="memitem">
  770. <div class="memproto">
  771. <table class="mlabels">
  772. <tr>
  773. <td class="mlabels-left">
  774. <table class="memname">
  775. <tr>
  776. <td class="memname">bool ExFatFile::isHidden </td>
  777. <td>(</td>
  778. <td class="paramname"></td><td>)</td>
  779. <td> const</td>
  780. </tr>
  781. </table>
  782. </td>
  783. <td class="mlabels-right">
  784. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  785. </tr>
  786. </table>
  787. </div><div class="memdoc">
  788. <dl class="section return"><dt>Returns</dt><dd>True if this is a hidden. </dd></dl>
  789. </div>
  790. </div>
  791. <a id="a804c34bbe3ebefe2b6c1d77ff8d49a35"></a>
  792. <h2 class="memtitle"><span class="permalink"><a href="#a804c34bbe3ebefe2b6c1d77ff8d49a35">&#9670;&nbsp;</a></span>isOpen()</h2>
  793. <div class="memitem">
  794. <div class="memproto">
  795. <table class="mlabels">
  796. <tr>
  797. <td class="mlabels-left">
  798. <table class="memname">
  799. <tr>
  800. <td class="memname">bool ExFatFile::isOpen </td>
  801. <td>(</td>
  802. <td class="paramname"></td><td>)</td>
  803. <td> const</td>
  804. </tr>
  805. </table>
  806. </td>
  807. <td class="mlabels-right">
  808. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  809. </tr>
  810. </table>
  811. </div><div class="memdoc">
  812. <dl class="section return"><dt>Returns</dt><dd>true if the file is open. </dd></dl>
  813. </div>
  814. </div>
  815. <a id="a9ca137dfba2c7772910f4d2b3fdd9411"></a>
  816. <h2 class="memtitle"><span class="permalink"><a href="#a9ca137dfba2c7772910f4d2b3fdd9411">&#9670;&nbsp;</a></span>isReadable()</h2>
  817. <div class="memitem">
  818. <div class="memproto">
  819. <table class="mlabels">
  820. <tr>
  821. <td class="mlabels-left">
  822. <table class="memname">
  823. <tr>
  824. <td class="memname">bool ExFatFile::isReadable </td>
  825. <td>(</td>
  826. <td class="paramname"></td><td>)</td>
  827. <td> const</td>
  828. </tr>
  829. </table>
  830. </td>
  831. <td class="mlabels-right">
  832. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  833. </tr>
  834. </table>
  835. </div><div class="memdoc">
  836. <dl class="section return"><dt>Returns</dt><dd>True file is writable. </dd></dl>
  837. </div>
  838. </div>
  839. <a id="a14d160bfbfb39717746b93fa2eda5739"></a>
  840. <h2 class="memtitle"><span class="permalink"><a href="#a14d160bfbfb39717746b93fa2eda5739">&#9670;&nbsp;</a></span>isReadOnly()</h2>
  841. <div class="memitem">
  842. <div class="memproto">
  843. <table class="mlabels">
  844. <tr>
  845. <td class="mlabels-left">
  846. <table class="memname">
  847. <tr>
  848. <td class="memname">bool ExFatFile::isReadOnly </td>
  849. <td>(</td>
  850. <td class="paramname"></td><td>)</td>
  851. <td> const</td>
  852. </tr>
  853. </table>
  854. </td>
  855. <td class="mlabels-right">
  856. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  857. </tr>
  858. </table>
  859. </div><div class="memdoc">
  860. <dl class="section return"><dt>Returns</dt><dd>True if file is read-only </dd></dl>
  861. </div>
  862. </div>
  863. <a id="ad9f8e7afcf749ebcaaf055bd569dc7da"></a>
  864. <h2 class="memtitle"><span class="permalink"><a href="#ad9f8e7afcf749ebcaaf055bd569dc7da">&#9670;&nbsp;</a></span>isRoot()</h2>
  865. <div class="memitem">
  866. <div class="memproto">
  867. <table class="mlabels">
  868. <tr>
  869. <td class="mlabels-left">
  870. <table class="memname">
  871. <tr>
  872. <td class="memname">bool ExFatFile::isRoot </td>
  873. <td>(</td>
  874. <td class="paramname"></td><td>)</td>
  875. <td> const</td>
  876. </tr>
  877. </table>
  878. </td>
  879. <td class="mlabels-right">
  880. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  881. </tr>
  882. </table>
  883. </div><div class="memdoc">
  884. <dl class="section return"><dt>Returns</dt><dd>True if this is the root directory. </dd></dl>
  885. </div>
  886. </div>
  887. <a id="ad7e02a1db8fb5a90288bb4679e9ddcb9"></a>
  888. <h2 class="memtitle"><span class="permalink"><a href="#ad7e02a1db8fb5a90288bb4679e9ddcb9">&#9670;&nbsp;</a></span>isSubDir()</h2>
  889. <div class="memitem">
  890. <div class="memproto">
  891. <table class="mlabels">
  892. <tr>
  893. <td class="mlabels-left">
  894. <table class="memname">
  895. <tr>
  896. <td class="memname">bool ExFatFile::isSubDir </td>
  897. <td>(</td>
  898. <td class="paramname"></td><td>)</td>
  899. <td> const</td>
  900. </tr>
  901. </table>
  902. </td>
  903. <td class="mlabels-right">
  904. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  905. </tr>
  906. </table>
  907. </div><div class="memdoc">
  908. <dl class="section return"><dt>Returns</dt><dd>True if this is a subdirectory. </dd></dl>
  909. </div>
  910. </div>
  911. <a id="a04d1c43e80743f8c1a51b64062ce16dd"></a>
  912. <h2 class="memtitle"><span class="permalink"><a href="#a04d1c43e80743f8c1a51b64062ce16dd">&#9670;&nbsp;</a></span>isWritable()</h2>
  913. <div class="memitem">
  914. <div class="memproto">
  915. <table class="mlabels">
  916. <tr>
  917. <td class="mlabels-left">
  918. <table class="memname">
  919. <tr>
  920. <td class="memname">bool ExFatFile::isWritable </td>
  921. <td>(</td>
  922. <td class="paramname"></td><td>)</td>
  923. <td> const</td>
  924. </tr>
  925. </table>
  926. </td>
  927. <td class="mlabels-right">
  928. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  929. </tr>
  930. </table>
  931. </div><div class="memdoc">
  932. <dl class="section return"><dt>Returns</dt><dd>True file is writable. </dd></dl>
  933. </div>
  934. </div>
  935. <a id="aa0e074c891f3db5ea2ebd491667b03a6"></a>
  936. <h2 class="memtitle"><span class="permalink"><a href="#aa0e074c891f3db5ea2ebd491667b03a6">&#9670;&nbsp;</a></span>ls() <span class="overload">[1/2]</span></h2>
  937. <div class="memitem">
  938. <div class="memproto">
  939. <table class="memname">
  940. <tr>
  941. <td class="memname">bool ExFatFile::ls </td>
  942. <td>(</td>
  943. <td class="paramtype"><a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  944. <td class="paramname"><em>pr</em></td><td>)</td>
  945. <td></td>
  946. </tr>
  947. </table>
  948. </div><div class="memdoc">
  949. <p>List directory contents.</p>
  950. <dl class="params"><dt>Parameters</dt><dd>
  951. <table class="params">
  952. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for list. </td></tr>
  953. </table>
  954. </dd>
  955. </dl>
  956. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  957. </div>
  958. </div>
  959. <a id="a09f8beb55f939874e93c1df6c8a046d4"></a>
  960. <h2 class="memtitle"><span class="permalink"><a href="#a09f8beb55f939874e93c1df6c8a046d4">&#9670;&nbsp;</a></span>ls() <span class="overload">[2/2]</span></h2>
  961. <div class="memitem">
  962. <div class="memproto">
  963. <table class="memname">
  964. <tr>
  965. <td class="memname">bool ExFatFile::ls </td>
  966. <td>(</td>
  967. <td class="paramtype"><a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  968. <td class="paramname"><em>pr</em>, </td>
  969. </tr>
  970. <tr>
  971. <td class="paramkey"></td>
  972. <td></td>
  973. <td class="paramtype">uint8_t&#160;</td>
  974. <td class="paramname"><em>flags</em>, </td>
  975. </tr>
  976. <tr>
  977. <td class="paramkey"></td>
  978. <td></td>
  979. <td class="paramtype">uint8_t&#160;</td>
  980. <td class="paramname"><em>indent</em> = <code>0</code>&#160;</td>
  981. </tr>
  982. <tr>
  983. <td></td>
  984. <td>)</td>
  985. <td></td><td></td>
  986. </tr>
  987. </table>
  988. </div><div class="memdoc">
  989. <p>List directory contents.</p>
  990. <dl class="params"><dt>Parameters</dt><dd>
  991. <table class="params">
  992. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for list.</td></tr>
  993. <tr><td class="paramdir">[in]</td><td class="paramname">flags</td><td>The inclusive OR of</td></tr>
  994. </table>
  995. </dd>
  996. </dl>
  997. <p>LS_DATE - Print file modification date</p>
  998. <p>LS_SIZE - Print file size.</p>
  999. <p>LS_R - Recursive list of subdirectories.</p>
  1000. <dl class="params"><dt>Parameters</dt><dd>
  1001. <table class="params">
  1002. <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>
  1003. </table>
  1004. </dd>
  1005. </dl>
  1006. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1007. </div>
  1008. </div>
  1009. <a id="a3a393624d52854e74bf385c9e513a86d"></a>
  1010. <h2 class="memtitle"><span class="permalink"><a href="#a3a393624d52854e74bf385c9e513a86d">&#9670;&nbsp;</a></span>mkdir()</h2>
  1011. <div class="memitem">
  1012. <div class="memproto">
  1013. <table class="memname">
  1014. <tr>
  1015. <td class="memname">bool ExFatFile::mkdir </td>
  1016. <td>(</td>
  1017. <td class="paramtype"><a class="el" href="class_ex_fat_file.html">ExFatFile</a> *&#160;</td>
  1018. <td class="paramname"><em>parent</em>, </td>
  1019. </tr>
  1020. <tr>
  1021. <td class="paramkey"></td>
  1022. <td></td>
  1023. <td class="paramtype">const ExChar_t *&#160;</td>
  1024. <td class="paramname"><em>path</em>, </td>
  1025. </tr>
  1026. <tr>
  1027. <td class="paramkey"></td>
  1028. <td></td>
  1029. <td class="paramtype">bool&#160;</td>
  1030. <td class="paramname"><em>pFlag</em> = <code>true</code>&#160;</td>
  1031. </tr>
  1032. <tr>
  1033. <td></td>
  1034. <td>)</td>
  1035. <td></td><td></td>
  1036. </tr>
  1037. </table>
  1038. </div><div class="memdoc">
  1039. <p>Make a new directory.</p>
  1040. <dl class="params"><dt>Parameters</dt><dd>
  1041. <table class="params">
  1042. <tr><td class="paramdir">[in]</td><td class="paramname">parent</td><td>An open directory file that will contain the new directory.</td></tr>
  1043. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid name for the new directory.</td></tr>
  1044. <tr><td class="paramdir">[in]</td><td class="paramname">pFlag</td><td>Create missing parent directories if true.</td></tr>
  1045. </table>
  1046. </dd>
  1047. </dl>
  1048. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1049. </div>
  1050. </div>
  1051. <a id="ab1e224aba9eb796c7ad48062cc1434c2"></a>
  1052. <h2 class="memtitle"><span class="permalink"><a href="#ab1e224aba9eb796c7ad48062cc1434c2">&#9670;&nbsp;</a></span>open() <span class="overload">[1/4]</span></h2>
  1053. <div class="memitem">
  1054. <div class="memproto">
  1055. <table class="memname">
  1056. <tr>
  1057. <td class="memname">bool ExFatFile::open </td>
  1058. <td>(</td>
  1059. <td class="paramtype">const ExChar_t *&#160;</td>
  1060. <td class="paramname"><em>path</em>, </td>
  1061. </tr>
  1062. <tr>
  1063. <td class="paramkey"></td>
  1064. <td></td>
  1065. <td class="paramtype">int&#160;</td>
  1066. <td class="paramname"><em>oflag</em> = <code>0X00</code>&#160;</td>
  1067. </tr>
  1068. <tr>
  1069. <td></td>
  1070. <td>)</td>
  1071. <td></td><td></td>
  1072. </tr>
  1073. </table>
  1074. </div><div class="memdoc">
  1075. <p>Open a file in the current working directory.</p>
  1076. <dl class="params"><dt>Parameters</dt><dd>
  1077. <table class="params">
  1078. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>A path with a valid name for a file to be opened.</td></tr>
  1079. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>bitwise-inclusive OR of open flags. See see <a class="el" href="class_ex_fat_file.html#ad0be05c5c7092317089872778052cbd7">ExFatFile::open(ExFatFile*, const char*, uint8_t)</a>.</td></tr>
  1080. </table>
  1081. </dd>
  1082. </dl>
  1083. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1084. </div>
  1085. </div>
  1086. <a id="ad0be05c5c7092317089872778052cbd7"></a>
  1087. <h2 class="memtitle"><span class="permalink"><a href="#ad0be05c5c7092317089872778052cbd7">&#9670;&nbsp;</a></span>open() <span class="overload">[2/4]</span></h2>
  1088. <div class="memitem">
  1089. <div class="memproto">
  1090. <table class="memname">
  1091. <tr>
  1092. <td class="memname">bool ExFatFile::open </td>
  1093. <td>(</td>
  1094. <td class="paramtype"><a class="el" href="class_ex_fat_file.html">ExFatFile</a> *&#160;</td>
  1095. <td class="paramname"><em>dirFile</em>, </td>
  1096. </tr>
  1097. <tr>
  1098. <td class="paramkey"></td>
  1099. <td></td>
  1100. <td class="paramtype">const ExChar_t *&#160;</td>
  1101. <td class="paramname"><em>path</em>, </td>
  1102. </tr>
  1103. <tr>
  1104. <td class="paramkey"></td>
  1105. <td></td>
  1106. <td class="paramtype">oflag_t&#160;</td>
  1107. <td class="paramname"><em>oflag</em>&#160;</td>
  1108. </tr>
  1109. <tr>
  1110. <td></td>
  1111. <td>)</td>
  1112. <td></td><td></td>
  1113. </tr>
  1114. </table>
  1115. </div><div class="memdoc">
  1116. <p>Open a file or directory by name.</p>
  1117. <dl class="params"><dt>Parameters</dt><dd>
  1118. <table class="params">
  1119. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>An open directory containing the file to be opened.</td></tr>
  1120. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>The path for a file to be opened.</td></tr>
  1121. <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. Only one of O_RDONLY, O_READ, O_WRONLY, O_WRITE, or O_RDWR is allowed.</td></tr>
  1122. </table>
  1123. </dd>
  1124. </dl>
  1125. <p>O_RDONLY - Open for reading.</p>
  1126. <p>O_READ - Same as O_RDONLY.</p>
  1127. <p>O_WRONLY - Open for writing.</p>
  1128. <p>O_WRITE - Same as O_WRONLY.</p>
  1129. <p>O_RDWR - Open for reading and writing.</p>
  1130. <p>O_APPEND - If set, the file offset shall be set to the end of the file prior to each write.</p>
  1131. <p>O_AT_END - Set the initial position at the end of the file.</p>
  1132. <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>
  1133. <p>O_EXCL - If O_CREAT and O_EXCL are set, <a class="el" href="class_ex_fat_file.html#ad0be05c5c7092317089872778052cbd7">open()</a> shall fail if the file exists.</p>
  1134. <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>
  1135. <p>WARNING: A given file must not be opened by more than one file object or file corruption may occur.</p>
  1136. <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>
  1137. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1138. </div>
  1139. </div>
  1140. <a id="a414b64dc30551e05dcc46f04e0f6413a"></a>
  1141. <h2 class="memtitle"><span class="permalink"><a href="#a414b64dc30551e05dcc46f04e0f6413a">&#9670;&nbsp;</a></span>open() <span class="overload">[3/4]</span></h2>
  1142. <div class="memitem">
  1143. <div class="memproto">
  1144. <table class="memname">
  1145. <tr>
  1146. <td class="memname">bool ExFatFile::open </td>
  1147. <td>(</td>
  1148. <td class="paramtype"><a class="el" href="class_ex_fat_file.html">ExFatFile</a> *&#160;</td>
  1149. <td class="paramname"><em>dirFile</em>, </td>
  1150. </tr>
  1151. <tr>
  1152. <td class="paramkey"></td>
  1153. <td></td>
  1154. <td class="paramtype">uint32_t&#160;</td>
  1155. <td class="paramname"><em>index</em>, </td>
  1156. </tr>
  1157. <tr>
  1158. <td class="paramkey"></td>
  1159. <td></td>
  1160. <td class="paramtype">oflag_t&#160;</td>
  1161. <td class="paramname"><em>oflag</em>&#160;</td>
  1162. </tr>
  1163. <tr>
  1164. <td></td>
  1165. <td>)</td>
  1166. <td></td><td></td>
  1167. </tr>
  1168. </table>
  1169. </div><div class="memdoc">
  1170. <p>Open a file by index.</p>
  1171. <dl class="params"><dt>Parameters</dt><dd>
  1172. <table class="params">
  1173. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>An open <a class="el" href="class_ex_fat_file.html" title="Basic file class.">ExFatFile</a> instance for the directory.</td></tr>
  1174. <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>
  1175. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>bitwise-inclusive OR of open flags. See see <a class="el" href="class_ex_fat_file.html#ad0be05c5c7092317089872778052cbd7">ExFatFile::open(ExFatFile*, const ExChar_t*, uint8_t)</a>.</td></tr>
  1176. </table>
  1177. </dd>
  1178. </dl>
  1179. <p>See <a class="el" href="class_ex_fat_file.html#ad0be05c5c7092317089872778052cbd7">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>
  1180. </div>
  1181. </div>
  1182. <a id="a825447643e6c9e8284a3ed78e3363788"></a>
  1183. <h2 class="memtitle"><span class="permalink"><a href="#a825447643e6c9e8284a3ed78e3363788">&#9670;&nbsp;</a></span>open() <span class="overload">[4/4]</span></h2>
  1184. <div class="memitem">
  1185. <div class="memproto">
  1186. <table class="memname">
  1187. <tr>
  1188. <td class="memname">bool ExFatFile::open </td>
  1189. <td>(</td>
  1190. <td class="paramtype"><a class="el" href="class_ex_fat_volume.html">ExFatVolume</a> *&#160;</td>
  1191. <td class="paramname"><em>vol</em>, </td>
  1192. </tr>
  1193. <tr>
  1194. <td class="paramkey"></td>
  1195. <td></td>
  1196. <td class="paramtype">const ExChar_t *&#160;</td>
  1197. <td class="paramname"><em>path</em>, </td>
  1198. </tr>
  1199. <tr>
  1200. <td class="paramkey"></td>
  1201. <td></td>
  1202. <td class="paramtype">int&#160;</td>
  1203. <td class="paramname"><em>oflag</em>&#160;</td>
  1204. </tr>
  1205. <tr>
  1206. <td></td>
  1207. <td>)</td>
  1208. <td></td><td></td>
  1209. </tr>
  1210. </table>
  1211. </div><div class="memdoc">
  1212. <p>Open a file in the volume working directory.</p>
  1213. <dl class="params"><dt>Parameters</dt><dd>
  1214. <table class="params">
  1215. <tr><td class="paramdir">[in]</td><td class="paramname">vol</td><td>Volume where the file is located.</td></tr>
  1216. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>with a valid name for a file to be opened.</td></tr>
  1217. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>bitwise-inclusive OR of open flags. See see <a class="el" href="class_ex_fat_file.html#ad0be05c5c7092317089872778052cbd7">open(ExFatFile*, const char*, uint8_t)</a>.</td></tr>
  1218. </table>
  1219. </dd>
  1220. </dl>
  1221. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1222. </div>
  1223. </div>
  1224. <a id="a89b6021cf70b7adb9feb162260d5a101"></a>
  1225. <h2 class="memtitle"><span class="permalink"><a href="#a89b6021cf70b7adb9feb162260d5a101">&#9670;&nbsp;</a></span>openNext()</h2>
  1226. <div class="memitem">
  1227. <div class="memproto">
  1228. <table class="memname">
  1229. <tr>
  1230. <td class="memname">bool ExFatFile::openNext </td>
  1231. <td>(</td>
  1232. <td class="paramtype"><a class="el" href="class_ex_fat_file.html">ExFatFile</a> *&#160;</td>
  1233. <td class="paramname"><em>dirFile</em>, </td>
  1234. </tr>
  1235. <tr>
  1236. <td class="paramkey"></td>
  1237. <td></td>
  1238. <td class="paramtype">oflag_t&#160;</td>
  1239. <td class="paramname"><em>oflag</em> = <code>0X00</code>&#160;</td>
  1240. </tr>
  1241. <tr>
  1242. <td></td>
  1243. <td>)</td>
  1244. <td></td><td></td>
  1245. </tr>
  1246. </table>
  1247. </div><div class="memdoc">
  1248. <p>Open the next file or subdirectory in a directory.</p>
  1249. <dl class="params"><dt>Parameters</dt><dd>
  1250. <table class="params">
  1251. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>An open instance for the directory containing the file to be opened.</td></tr>
  1252. <tr><td class="paramdir">[in]</td><td class="paramname">oflag</td><td>bitwise-inclusive OR of open flags. See see <a class="el" href="class_ex_fat_file.html#ad0be05c5c7092317089872778052cbd7">open(ExFatFile*, const char*, uint8_t)</a>.</td></tr>
  1253. </table>
  1254. </dd>
  1255. </dl>
  1256. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1257. </div>
  1258. </div>
  1259. <a id="af664c1da1bfa0bb5f6eb933bc25f757e"></a>
  1260. <h2 class="memtitle"><span class="permalink"><a href="#af664c1da1bfa0bb5f6eb933bc25f757e">&#9670;&nbsp;</a></span>openRoot()</h2>
  1261. <div class="memitem">
  1262. <div class="memproto">
  1263. <table class="memname">
  1264. <tr>
  1265. <td class="memname">bool ExFatFile::openRoot </td>
  1266. <td>(</td>
  1267. <td class="paramtype"><a class="el" href="class_ex_fat_volume.html">ExFatVolume</a> *&#160;</td>
  1268. <td class="paramname"><em>vol</em></td><td>)</td>
  1269. <td></td>
  1270. </tr>
  1271. </table>
  1272. </div><div class="memdoc">
  1273. <p>Open a volume's root directory.</p>
  1274. <dl class="params"><dt>Parameters</dt><dd>
  1275. <table class="params">
  1276. <tr><td class="paramdir">[in]</td><td class="paramname">vol</td><td>The FAT volume containing the root directory to be opened.</td></tr>
  1277. </table>
  1278. </dd>
  1279. </dl>
  1280. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1281. </div>
  1282. </div>
  1283. <a id="aa1abbd813f27d488f0ff439ccbc9ca98"></a>
  1284. <h2 class="memtitle"><span class="permalink"><a href="#aa1abbd813f27d488f0ff439ccbc9ca98">&#9670;&nbsp;</a></span>operator bool()</h2>
  1285. <div class="memitem">
  1286. <div class="memproto">
  1287. <table class="mlabels">
  1288. <tr>
  1289. <td class="mlabels-left">
  1290. <table class="memname">
  1291. <tr>
  1292. <td class="memname">ExFatFile::operator bool </td>
  1293. <td>(</td>
  1294. <td class="paramname"></td><td>)</td>
  1295. <td></td>
  1296. </tr>
  1297. </table>
  1298. </td>
  1299. <td class="mlabels-right">
  1300. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1301. </tr>
  1302. </table>
  1303. </div><div class="memdoc">
  1304. <p>The parenthesis operator.</p>
  1305. <dl class="section return"><dt>Returns</dt><dd>true if a file is open. </dd></dl>
  1306. </div>
  1307. </div>
  1308. <a id="afc2e375faa696545f7ebbf583faae72a"></a>
  1309. <h2 class="memtitle"><span class="permalink"><a href="#afc2e375faa696545f7ebbf583faae72a">&#9670;&nbsp;</a></span>peek()</h2>
  1310. <div class="memitem">
  1311. <div class="memproto">
  1312. <table class="memname">
  1313. <tr>
  1314. <td class="memname">int ExFatFile::peek </td>
  1315. <td>(</td>
  1316. <td class="paramname"></td><td>)</td>
  1317. <td></td>
  1318. </tr>
  1319. </table>
  1320. </div><div class="memdoc">
  1321. <p>Return the next available byte without consuming it.</p>
  1322. <dl class="section return"><dt>Returns</dt><dd>The byte if no error and not at eof else -1; </dd></dl>
  1323. </div>
  1324. </div>
  1325. <a id="a35a5093014e80965e49c84b61780556f"></a>
  1326. <h2 class="memtitle"><span class="permalink"><a href="#a35a5093014e80965e49c84b61780556f">&#9670;&nbsp;</a></span>preAllocate()</h2>
  1327. <div class="memitem">
  1328. <div class="memproto">
  1329. <table class="memname">
  1330. <tr>
  1331. <td class="memname">bool ExFatFile::preAllocate </td>
  1332. <td>(</td>
  1333. <td class="paramtype">uint64_t&#160;</td>
  1334. <td class="paramname"><em>length</em></td><td>)</td>
  1335. <td></td>
  1336. </tr>
  1337. </table>
  1338. </div><div class="memdoc">
  1339. <p>Allocate contiguous clusters to an empty file.</p>
  1340. <p>The file must be empty with no clusters allocated.</p>
  1341. <p>The file will have zero validLength and dataLength will equal the requested length.</p>
  1342. <dl class="params"><dt>Parameters</dt><dd>
  1343. <table class="params">
  1344. <tr><td class="paramdir">[in]</td><td class="paramname">length</td><td>size of allocated space in bytes. </td></tr>
  1345. </table>
  1346. </dd>
  1347. </dl>
  1348. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1349. </div>
  1350. </div>
  1351. <a id="ad9ba8aa00b9db683d40fc2989dbe1922"></a>
  1352. <h2 class="memtitle"><span class="permalink"><a href="#ad9ba8aa00b9db683d40fc2989dbe1922">&#9670;&nbsp;</a></span>printAccessDateTime()</h2>
  1353. <div class="memitem">
  1354. <div class="memproto">
  1355. <table class="memname">
  1356. <tr>
  1357. <td class="memname">size_t ExFatFile::printAccessDateTime </td>
  1358. <td>(</td>
  1359. <td class="paramtype"><a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  1360. <td class="paramname"><em>pr</em></td><td>)</td>
  1361. <td></td>
  1362. </tr>
  1363. </table>
  1364. </div><div class="memdoc">
  1365. <p>Print a file's access date and time</p>
  1366. <dl class="params"><dt>Parameters</dt><dd>
  1367. <table class="params">
  1368. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  1369. </table>
  1370. </dd>
  1371. </dl>
  1372. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1373. </div>
  1374. </div>
  1375. <a id="a7318b2d7594d6ba52421c413f5fc35cd"></a>
  1376. <h2 class="memtitle"><span class="permalink"><a href="#a7318b2d7594d6ba52421c413f5fc35cd">&#9670;&nbsp;</a></span>printCreateDateTime()</h2>
  1377. <div class="memitem">
  1378. <div class="memproto">
  1379. <table class="memname">
  1380. <tr>
  1381. <td class="memname">size_t ExFatFile::printCreateDateTime </td>
  1382. <td>(</td>
  1383. <td class="paramtype"><a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  1384. <td class="paramname"><em>pr</em></td><td>)</td>
  1385. <td></td>
  1386. </tr>
  1387. </table>
  1388. </div><div class="memdoc">
  1389. <p>Print a file's creation date and time</p>
  1390. <dl class="params"><dt>Parameters</dt><dd>
  1391. <table class="params">
  1392. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  1393. </table>
  1394. </dd>
  1395. </dl>
  1396. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1397. </div>
  1398. </div>
  1399. <a id="a496ac61e367a24665425d54956a46346"></a>
  1400. <h2 class="memtitle"><span class="permalink"><a href="#a496ac61e367a24665425d54956a46346">&#9670;&nbsp;</a></span>printField() <span class="overload">[1/3]</span></h2>
  1401. <div class="memitem">
  1402. <div class="memproto">
  1403. <table class="mlabels">
  1404. <tr>
  1405. <td class="mlabels-left">
  1406. <table class="memname">
  1407. <tr>
  1408. <td class="memname">size_t ExFatFile::printField </td>
  1409. <td>(</td>
  1410. <td class="paramtype">double&#160;</td>
  1411. <td class="paramname"><em>value</em>, </td>
  1412. </tr>
  1413. <tr>
  1414. <td class="paramkey"></td>
  1415. <td></td>
  1416. <td class="paramtype">char&#160;</td>
  1417. <td class="paramname"><em>term</em>, </td>
  1418. </tr>
  1419. <tr>
  1420. <td class="paramkey"></td>
  1421. <td></td>
  1422. <td class="paramtype">uint8_t&#160;</td>
  1423. <td class="paramname"><em>prec</em> = <code>2</code>&#160;</td>
  1424. </tr>
  1425. <tr>
  1426. <td></td>
  1427. <td>)</td>
  1428. <td></td><td></td>
  1429. </tr>
  1430. </table>
  1431. </td>
  1432. <td class="mlabels-right">
  1433. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1434. </tr>
  1435. </table>
  1436. </div><div class="memdoc">
  1437. <p>Print a number followed by a field terminator. </p><dl class="params"><dt>Parameters</dt><dd>
  1438. <table class="params">
  1439. <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The number to be printed. </td></tr>
  1440. <tr><td class="paramdir">[in]</td><td class="paramname">term</td><td>The field terminator. Use '\n' for CR LF. </td></tr>
  1441. <tr><td class="paramdir">[in]</td><td class="paramname">prec</td><td>Number of digits after decimal point. </td></tr>
  1442. </table>
  1443. </dd>
  1444. </dl>
  1445. <dl class="section return"><dt>Returns</dt><dd>The number of bytes written or -1 if an error occurs. </dd></dl>
  1446. </div>
  1447. </div>
  1448. <a id="a70eda4191df90f608694c1faede7fb33"></a>
  1449. <h2 class="memtitle"><span class="permalink"><a href="#a70eda4191df90f608694c1faede7fb33">&#9670;&nbsp;</a></span>printField() <span class="overload">[2/3]</span></h2>
  1450. <div class="memitem">
  1451. <div class="memproto">
  1452. <table class="mlabels">
  1453. <tr>
  1454. <td class="mlabels-left">
  1455. <table class="memname">
  1456. <tr>
  1457. <td class="memname">size_t ExFatFile::printField </td>
  1458. <td>(</td>
  1459. <td class="paramtype">float&#160;</td>
  1460. <td class="paramname"><em>value</em>, </td>
  1461. </tr>
  1462. <tr>
  1463. <td class="paramkey"></td>
  1464. <td></td>
  1465. <td class="paramtype">char&#160;</td>
  1466. <td class="paramname"><em>term</em>, </td>
  1467. </tr>
  1468. <tr>
  1469. <td class="paramkey"></td>
  1470. <td></td>
  1471. <td class="paramtype">uint8_t&#160;</td>
  1472. <td class="paramname"><em>prec</em> = <code>2</code>&#160;</td>
  1473. </tr>
  1474. <tr>
  1475. <td></td>
  1476. <td>)</td>
  1477. <td></td><td></td>
  1478. </tr>
  1479. </table>
  1480. </td>
  1481. <td class="mlabels-right">
  1482. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1483. </tr>
  1484. </table>
  1485. </div><div class="memdoc">
  1486. <p>Print a number followed by a field terminator. </p><dl class="params"><dt>Parameters</dt><dd>
  1487. <table class="params">
  1488. <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The number to be printed. </td></tr>
  1489. <tr><td class="paramdir">[in]</td><td class="paramname">term</td><td>The field terminator. Use '\n' for CR LF. </td></tr>
  1490. <tr><td class="paramdir">[in]</td><td class="paramname">prec</td><td>Number of digits after decimal point. </td></tr>
  1491. </table>
  1492. </dd>
  1493. </dl>
  1494. <dl class="section return"><dt>Returns</dt><dd>The number of bytes written or -1 if an error occurs. </dd></dl>
  1495. </div>
  1496. </div>
  1497. <a id="a9759c13e804c01ff9e7e2ac8fbabc5b8"></a>
  1498. <h2 class="memtitle"><span class="permalink"><a href="#a9759c13e804c01ff9e7e2ac8fbabc5b8">&#9670;&nbsp;</a></span>printField() <span class="overload">[3/3]</span></h2>
  1499. <div class="memitem">
  1500. <div class="memproto">
  1501. <div class="memtemplate">
  1502. template&lt;typename Type &gt; </div>
  1503. <table class="mlabels">
  1504. <tr>
  1505. <td class="mlabels-left">
  1506. <table class="memname">
  1507. <tr>
  1508. <td class="memname">size_t ExFatFile::printField </td>
  1509. <td>(</td>
  1510. <td class="paramtype">Type&#160;</td>
  1511. <td class="paramname"><em>value</em>, </td>
  1512. </tr>
  1513. <tr>
  1514. <td class="paramkey"></td>
  1515. <td></td>
  1516. <td class="paramtype">char&#160;</td>
  1517. <td class="paramname"><em>term</em>&#160;</td>
  1518. </tr>
  1519. <tr>
  1520. <td></td>
  1521. <td>)</td>
  1522. <td></td><td></td>
  1523. </tr>
  1524. </table>
  1525. </td>
  1526. <td class="mlabels-right">
  1527. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1528. </tr>
  1529. </table>
  1530. </div><div class="memdoc">
  1531. <p>Print a number followed by a field terminator. </p><dl class="params"><dt>Parameters</dt><dd>
  1532. <table class="params">
  1533. <tr><td class="paramdir">[in]</td><td class="paramname">value</td><td>The number to be printed. </td></tr>
  1534. <tr><td class="paramdir">[in]</td><td class="paramname">term</td><td>The field terminator. Use '\n' for CR LF. </td></tr>
  1535. </table>
  1536. </dd>
  1537. </dl>
  1538. <dl class="section return"><dt>Returns</dt><dd>The number of bytes written or -1 if an error occurs. </dd></dl>
  1539. </div>
  1540. </div>
  1541. <a id="a16d527f98cff3ffd3ba8bc594a22d186"></a>
  1542. <h2 class="memtitle"><span class="permalink"><a href="#a16d527f98cff3ffd3ba8bc594a22d186">&#9670;&nbsp;</a></span>printFileSize()</h2>
  1543. <div class="memitem">
  1544. <div class="memproto">
  1545. <table class="memname">
  1546. <tr>
  1547. <td class="memname">size_t ExFatFile::printFileSize </td>
  1548. <td>(</td>
  1549. <td class="paramtype"><a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  1550. <td class="paramname"><em>pr</em></td><td>)</td>
  1551. <td></td>
  1552. </tr>
  1553. </table>
  1554. </div><div class="memdoc">
  1555. <p>Print a file's size in bytes. </p><dl class="params"><dt>Parameters</dt><dd>
  1556. <table class="params">
  1557. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Prtin stream for the output. </td></tr>
  1558. </table>
  1559. </dd>
  1560. </dl>
  1561. <dl class="section return"><dt>Returns</dt><dd>The number of bytes printed. </dd></dl>
  1562. </div>
  1563. </div>
  1564. <a id="a16488d3e0d946f108240b7d6c536c6f4"></a>
  1565. <h2 class="memtitle"><span class="permalink"><a href="#a16488d3e0d946f108240b7d6c536c6f4">&#9670;&nbsp;</a></span>printModifyDateTime()</h2>
  1566. <div class="memitem">
  1567. <div class="memproto">
  1568. <table class="memname">
  1569. <tr>
  1570. <td class="memname">size_t ExFatFile::printModifyDateTime </td>
  1571. <td>(</td>
  1572. <td class="paramtype"><a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  1573. <td class="paramname"><em>pr</em></td><td>)</td>
  1574. <td></td>
  1575. </tr>
  1576. </table>
  1577. </div><div class="memdoc">
  1578. <p>Print a file's modify date and time</p>
  1579. <dl class="params"><dt>Parameters</dt><dd>
  1580. <table class="params">
  1581. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  1582. </table>
  1583. </dd>
  1584. </dl>
  1585. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1586. </div>
  1587. </div>
  1588. <a id="a095c0a865e5e5b6463c3dc0c90680635"></a>
  1589. <h2 class="memtitle"><span class="permalink"><a href="#a095c0a865e5e5b6463c3dc0c90680635">&#9670;&nbsp;</a></span>printName()</h2>
  1590. <div class="memitem">
  1591. <div class="memproto">
  1592. <table class="memname">
  1593. <tr>
  1594. <td class="memname">size_t ExFatFile::printName </td>
  1595. <td>(</td>
  1596. <td class="paramtype"><a class="el" href="_sys_call_8h.html#ac62f6449331cfe1a71f29be30efe7890">print_t</a> *&#160;</td>
  1597. <td class="paramname"><em>pr</em></td><td>)</td>
  1598. <td></td>
  1599. </tr>
  1600. </table>
  1601. </div><div class="memdoc">
  1602. <p>Print a file's name</p>
  1603. <dl class="params"><dt>Parameters</dt><dd>
  1604. <table class="params">
  1605. <tr><td class="paramdir">[in]</td><td class="paramname">pr</td><td>Print stream for output.</td></tr>
  1606. </table>
  1607. </dd>
  1608. </dl>
  1609. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1610. </div>
  1611. </div>
  1612. <a id="a77f4fea0aae0c8bae926fdfbba260a55"></a>
  1613. <h2 class="memtitle"><span class="permalink"><a href="#a77f4fea0aae0c8bae926fdfbba260a55">&#9670;&nbsp;</a></span>read() <span class="overload">[1/2]</span></h2>
  1614. <div class="memitem">
  1615. <div class="memproto">
  1616. <table class="mlabels">
  1617. <tr>
  1618. <td class="mlabels-left">
  1619. <table class="memname">
  1620. <tr>
  1621. <td class="memname">int ExFatFile::read </td>
  1622. <td>(</td>
  1623. <td class="paramname"></td><td>)</td>
  1624. <td></td>
  1625. </tr>
  1626. </table>
  1627. </td>
  1628. <td class="mlabels-right">
  1629. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1630. </tr>
  1631. </table>
  1632. </div><div class="memdoc">
  1633. <p>Read the next byte from a file.</p>
  1634. <dl class="section return"><dt>Returns</dt><dd>For success read returns the next byte in the file as an int. If an error occurs or end of file is reached -1 is returned. </dd></dl>
  1635. </div>
  1636. </div>
  1637. <a id="a5ae5477efe55179cf07e173c62654313"></a>
  1638. <h2 class="memtitle"><span class="permalink"><a href="#a5ae5477efe55179cf07e173c62654313">&#9670;&nbsp;</a></span>read() <span class="overload">[2/2]</span></h2>
  1639. <div class="memitem">
  1640. <div class="memproto">
  1641. <table class="memname">
  1642. <tr>
  1643. <td class="memname">int ExFatFile::read </td>
  1644. <td>(</td>
  1645. <td class="paramtype">void *&#160;</td>
  1646. <td class="paramname"><em>buf</em>, </td>
  1647. </tr>
  1648. <tr>
  1649. <td class="paramkey"></td>
  1650. <td></td>
  1651. <td class="paramtype">size_t&#160;</td>
  1652. <td class="paramname"><em>count</em>&#160;</td>
  1653. </tr>
  1654. <tr>
  1655. <td></td>
  1656. <td>)</td>
  1657. <td></td><td></td>
  1658. </tr>
  1659. </table>
  1660. </div><div class="memdoc">
  1661. <p>Read data from a file starting at the current position.</p>
  1662. <dl class="params"><dt>Parameters</dt><dd>
  1663. <table class="params">
  1664. <tr><td class="paramdir">[out]</td><td class="paramname">buf</td><td>Pointer to the location that will receive the data.</td></tr>
  1665. <tr><td class="paramdir">[in]</td><td class="paramname">count</td><td>Maximum number of bytes to read.</td></tr>
  1666. </table>
  1667. </dd>
  1668. </dl>
  1669. <dl class="section return"><dt>Returns</dt><dd>For success <a class="el" href="class_ex_fat_file.html#a77f4fea0aae0c8bae926fdfbba260a55">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_ex_fat_file.html#a77f4fea0aae0c8bae926fdfbba260a55">read()</a> returns -1. </dd></dl>
  1670. </div>
  1671. </div>
  1672. <a id="a8e88c8e79551a72cc98310038514c47a"></a>
  1673. <h2 class="memtitle"><span class="permalink"><a href="#a8e88c8e79551a72cc98310038514c47a">&#9670;&nbsp;</a></span>remove() <span class="overload">[1/2]</span></h2>
  1674. <div class="memitem">
  1675. <div class="memproto">
  1676. <table class="memname">
  1677. <tr>
  1678. <td class="memname">bool ExFatFile::remove </td>
  1679. <td>(</td>
  1680. <td class="paramname"></td><td>)</td>
  1681. <td></td>
  1682. </tr>
  1683. </table>
  1684. </div><div class="memdoc">
  1685. <p>Remove a file.</p>
  1686. <p>The directory entry and all data for the file are deleted.</p>
  1687. <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>
  1688. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1689. </div>
  1690. </div>
  1691. <a id="ad10417a851dba3d40a78eb2c0eb11fff"></a>
  1692. <h2 class="memtitle"><span class="permalink"><a href="#ad10417a851dba3d40a78eb2c0eb11fff">&#9670;&nbsp;</a></span>remove() <span class="overload">[2/2]</span></h2>
  1693. <div class="memitem">
  1694. <div class="memproto">
  1695. <table class="memname">
  1696. <tr>
  1697. <td class="memname">bool ExFatFile::remove </td>
  1698. <td>(</td>
  1699. <td class="paramtype">const ExChar_t *&#160;</td>
  1700. <td class="paramname"><em>path</em></td><td>)</td>
  1701. <td></td>
  1702. </tr>
  1703. </table>
  1704. </div><div class="memdoc">
  1705. <p>Remove a file.</p>
  1706. <p>The directory entry and all data for the file are deleted.</p>
  1707. <dl class="params"><dt>Parameters</dt><dd>
  1708. <table class="params">
  1709. <tr><td class="paramdir">[in]</td><td class="paramname">path</td><td>Path for the file to be removed.</td></tr>
  1710. </table>
  1711. </dd>
  1712. </dl>
  1713. <p>Example use: dirFile.remove(filenameToRemove);</p>
  1714. <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>
  1715. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1716. </div>
  1717. </div>
  1718. <a id="aab50b2646035f76834c75230d2b55c64"></a>
  1719. <h2 class="memtitle"><span class="permalink"><a href="#aab50b2646035f76834c75230d2b55c64">&#9670;&nbsp;</a></span>rename() <span class="overload">[1/2]</span></h2>
  1720. <div class="memitem">
  1721. <div class="memproto">
  1722. <table class="memname">
  1723. <tr>
  1724. <td class="memname">bool ExFatFile::rename </td>
  1725. <td>(</td>
  1726. <td class="paramtype">const ExChar_t *&#160;</td>
  1727. <td class="paramname"><em>newPath</em></td><td>)</td>
  1728. <td></td>
  1729. </tr>
  1730. </table>
  1731. </div><div class="memdoc">
  1732. <p>Rename a file or subdirectory.</p>
  1733. <dl class="params"><dt>Parameters</dt><dd>
  1734. <table class="params">
  1735. <tr><td class="paramdir">[in]</td><td class="paramname">newPath</td><td>New path name for the file/directory.</td></tr>
  1736. </table>
  1737. </dd>
  1738. </dl>
  1739. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1740. </div>
  1741. </div>
  1742. <a id="aea570a3b6afbe633d874803b137a46b8"></a>
  1743. <h2 class="memtitle"><span class="permalink"><a href="#aea570a3b6afbe633d874803b137a46b8">&#9670;&nbsp;</a></span>rename() <span class="overload">[2/2]</span></h2>
  1744. <div class="memitem">
  1745. <div class="memproto">
  1746. <table class="memname">
  1747. <tr>
  1748. <td class="memname">bool ExFatFile::rename </td>
  1749. <td>(</td>
  1750. <td class="paramtype"><a class="el" href="class_ex_fat_file.html">ExFatFile</a> *&#160;</td>
  1751. <td class="paramname"><em>dirFile</em>, </td>
  1752. </tr>
  1753. <tr>
  1754. <td class="paramkey"></td>
  1755. <td></td>
  1756. <td class="paramtype">const ExChar_t *&#160;</td>
  1757. <td class="paramname"><em>newPath</em>&#160;</td>
  1758. </tr>
  1759. <tr>
  1760. <td></td>
  1761. <td>)</td>
  1762. <td></td><td></td>
  1763. </tr>
  1764. </table>
  1765. </div><div class="memdoc">
  1766. <p>Rename a file or subdirectory.</p>
  1767. <dl class="params"><dt>Parameters</dt><dd>
  1768. <table class="params">
  1769. <tr><td class="paramdir">[in]</td><td class="paramname">dirFile</td><td>Directory for the new path. </td></tr>
  1770. <tr><td class="paramdir">[in]</td><td class="paramname">newPath</td><td>New path name for the file/directory.</td></tr>
  1771. </table>
  1772. </dd>
  1773. </dl>
  1774. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1775. </div>
  1776. </div>
  1777. <a id="a3c1d3ef65284ffb13ed3ceee472adf9a"></a>
  1778. <h2 class="memtitle"><span class="permalink"><a href="#a3c1d3ef65284ffb13ed3ceee472adf9a">&#9670;&nbsp;</a></span>rewind()</h2>
  1779. <div class="memitem">
  1780. <div class="memproto">
  1781. <table class="mlabels">
  1782. <tr>
  1783. <td class="mlabels-left">
  1784. <table class="memname">
  1785. <tr>
  1786. <td class="memname">void ExFatFile::rewind </td>
  1787. <td>(</td>
  1788. <td class="paramname"></td><td>)</td>
  1789. <td></td>
  1790. </tr>
  1791. </table>
  1792. </td>
  1793. <td class="mlabels-right">
  1794. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1795. </tr>
  1796. </table>
  1797. </div><div class="memdoc">
  1798. <p>Set the file's current position to zero. </p>
  1799. </div>
  1800. </div>
  1801. <a id="a0165e0fde12a53e419bd92cd37f9cfed"></a>
  1802. <h2 class="memtitle"><span class="permalink"><a href="#a0165e0fde12a53e419bd92cd37f9cfed">&#9670;&nbsp;</a></span>rmdir()</h2>
  1803. <div class="memitem">
  1804. <div class="memproto">
  1805. <table class="memname">
  1806. <tr>
  1807. <td class="memname">bool ExFatFile::rmdir </td>
  1808. <td>(</td>
  1809. <td class="paramname"></td><td>)</td>
  1810. <td></td>
  1811. </tr>
  1812. </table>
  1813. </div><div class="memdoc">
  1814. <p>Remove a directory file.</p>
  1815. <p>The directory file will be removed only if it is empty and is not the root directory. <a class="el" href="class_ex_fat_file.html#a0165e0fde12a53e419bd92cd37f9cfed">rmdir()</a> follows DOS and Windows and ignores the read-only attribute for the directory.</p>
  1816. <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>
  1817. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1818. </div>
  1819. </div>
  1820. <a id="ab42494880cf229adfb0fc8edb0647686"></a>
  1821. <h2 class="memtitle"><span class="permalink"><a href="#ab42494880cf229adfb0fc8edb0647686">&#9670;&nbsp;</a></span>seekCur()</h2>
  1822. <div class="memitem">
  1823. <div class="memproto">
  1824. <table class="mlabels">
  1825. <tr>
  1826. <td class="mlabels-left">
  1827. <table class="memname">
  1828. <tr>
  1829. <td class="memname">bool ExFatFile::seekCur </td>
  1830. <td>(</td>
  1831. <td class="paramtype">int64_t&#160;</td>
  1832. <td class="paramname"><em>offset</em></td><td>)</td>
  1833. <td></td>
  1834. </tr>
  1835. </table>
  1836. </td>
  1837. <td class="mlabels-right">
  1838. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1839. </tr>
  1840. </table>
  1841. </div><div class="memdoc">
  1842. <p>Set the files position to current position + <em>pos</em>. See <a class="el" href="class_ex_fat_file.html#a9834c4da2f14c66f4bda26938ebb36f6">seekSet()</a>. </p><dl class="params"><dt>Parameters</dt><dd>
  1843. <table class="params">
  1844. <tr><td class="paramdir">[in]</td><td class="paramname">offset</td><td>The new position in bytes from the current position. </td></tr>
  1845. </table>
  1846. </dd>
  1847. </dl>
  1848. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1849. </div>
  1850. </div>
  1851. <a id="a2994a71751ed4f137f48b2e9a7d94091"></a>
  1852. <h2 class="memtitle"><span class="permalink"><a href="#a2994a71751ed4f137f48b2e9a7d94091">&#9670;&nbsp;</a></span>seekEnd()</h2>
  1853. <div class="memitem">
  1854. <div class="memproto">
  1855. <table class="mlabels">
  1856. <tr>
  1857. <td class="mlabels-left">
  1858. <table class="memname">
  1859. <tr>
  1860. <td class="memname">bool ExFatFile::seekEnd </td>
  1861. <td>(</td>
  1862. <td class="paramtype">int64_t&#160;</td>
  1863. <td class="paramname"><em>offset</em> = <code>0</code></td><td>)</td>
  1864. <td></td>
  1865. </tr>
  1866. </table>
  1867. </td>
  1868. <td class="mlabels-right">
  1869. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  1870. </tr>
  1871. </table>
  1872. </div><div class="memdoc">
  1873. <p>Set the files position to end-of-file + <em>offset</em>. See <a class="el" href="class_ex_fat_file.html#a9834c4da2f14c66f4bda26938ebb36f6">seekSet()</a>. Can't be used for directory files since file size is not defined. </p><dl class="params"><dt>Parameters</dt><dd>
  1874. <table class="params">
  1875. <tr><td class="paramdir">[in]</td><td class="paramname">offset</td><td>The new position in bytes from end-of-file. </td></tr>
  1876. </table>
  1877. </dd>
  1878. </dl>
  1879. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1880. </div>
  1881. </div>
  1882. <a id="a9834c4da2f14c66f4bda26938ebb36f6"></a>
  1883. <h2 class="memtitle"><span class="permalink"><a href="#a9834c4da2f14c66f4bda26938ebb36f6">&#9670;&nbsp;</a></span>seekSet()</h2>
  1884. <div class="memitem">
  1885. <div class="memproto">
  1886. <table class="memname">
  1887. <tr>
  1888. <td class="memname">bool ExFatFile::seekSet </td>
  1889. <td>(</td>
  1890. <td class="paramtype">uint64_t&#160;</td>
  1891. <td class="paramname"><em>pos</em></td><td>)</td>
  1892. <td></td>
  1893. </tr>
  1894. </table>
  1895. </div><div class="memdoc">
  1896. <p>Sets a file's position.</p>
  1897. <dl class="params"><dt>Parameters</dt><dd>
  1898. <table class="params">
  1899. <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>
  1900. </table>
  1901. </dd>
  1902. </dl>
  1903. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1904. </div>
  1905. </div>
  1906. <a id="a2cb3638069afd2d01b79e5dff1a66f55"></a>
  1907. <h2 class="memtitle"><span class="permalink"><a href="#a2cb3638069afd2d01b79e5dff1a66f55">&#9670;&nbsp;</a></span>sync()</h2>
  1908. <div class="memitem">
  1909. <div class="memproto">
  1910. <table class="memname">
  1911. <tr>
  1912. <td class="memname">bool ExFatFile::sync </td>
  1913. <td>(</td>
  1914. <td class="paramname"></td><td>)</td>
  1915. <td></td>
  1916. </tr>
  1917. </table>
  1918. </div><div class="memdoc">
  1919. <p>The <a class="el" href="class_ex_fat_file.html#a2cb3638069afd2d01b79e5dff1a66f55">sync()</a> call causes all modified data and directory fields to be written to the storage device.</p>
  1920. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  1921. </div>
  1922. </div>
  1923. <a id="a6d3ab10983e206401ebd5c24a1c46174"></a>
  1924. <h2 class="memtitle"><span class="permalink"><a href="#a6d3ab10983e206401ebd5c24a1c46174">&#9670;&nbsp;</a></span>timestamp()</h2>
  1925. <div class="memitem">
  1926. <div class="memproto">
  1927. <table class="memname">
  1928. <tr>
  1929. <td class="memname">bool ExFatFile::timestamp </td>
  1930. <td>(</td>
  1931. <td class="paramtype">uint8_t&#160;</td>
  1932. <td class="paramname"><em>flags</em>, </td>
  1933. </tr>
  1934. <tr>
  1935. <td class="paramkey"></td>
  1936. <td></td>
  1937. <td class="paramtype">uint16_t&#160;</td>
  1938. <td class="paramname"><em>year</em>, </td>
  1939. </tr>
  1940. <tr>
  1941. <td class="paramkey"></td>
  1942. <td></td>
  1943. <td class="paramtype">uint8_t&#160;</td>
  1944. <td class="paramname"><em>month</em>, </td>
  1945. </tr>
  1946. <tr>
  1947. <td class="paramkey"></td>
  1948. <td></td>
  1949. <td class="paramtype">uint8_t&#160;</td>
  1950. <td class="paramname"><em>day</em>, </td>
  1951. </tr>
  1952. <tr>
  1953. <td class="paramkey"></td>
  1954. <td></td>
  1955. <td class="paramtype">uint8_t&#160;</td>
  1956. <td class="paramname"><em>hour</em>, </td>
  1957. </tr>
  1958. <tr>
  1959. <td class="paramkey"></td>
  1960. <td></td>
  1961. <td class="paramtype">uint8_t&#160;</td>
  1962. <td class="paramname"><em>minute</em>, </td>
  1963. </tr>
  1964. <tr>
  1965. <td class="paramkey"></td>
  1966. <td></td>
  1967. <td class="paramtype">uint8_t&#160;</td>
  1968. <td class="paramname"><em>second</em>&#160;</td>
  1969. </tr>
  1970. <tr>
  1971. <td></td>
  1972. <td>)</td>
  1973. <td></td><td></td>
  1974. </tr>
  1975. </table>
  1976. </div><div class="memdoc">
  1977. <p>Truncate a file at the current file position.</p>
  1978. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. Set a file's timestamps in its directory entry.</dd></dl>
  1979. <dl class="params"><dt>Parameters</dt><dd>
  1980. <table class="params">
  1981. <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>
  1982. </table>
  1983. </dd>
  1984. </dl>
  1985. <p>T_ACCESS - Set the file's last access date.</p>
  1986. <p>T_CREATE - Set the file's creation date and time.</p>
  1987. <p>T_WRITE - Set the file's last write/modification date and time.</p>
  1988. <dl class="params"><dt>Parameters</dt><dd>
  1989. <table class="params">
  1990. <tr><td class="paramdir">[in]</td><td class="paramname">year</td><td>Valid range 1980 - 2107 inclusive.</td></tr>
  1991. <tr><td class="paramdir">[in]</td><td class="paramname">month</td><td>Valid range 1 - 12 inclusive.</td></tr>
  1992. <tr><td class="paramdir">[in]</td><td class="paramname">day</td><td>Valid range 1 - 31 inclusive.</td></tr>
  1993. <tr><td class="paramdir">[in]</td><td class="paramname">hour</td><td>Valid range 0 - 23 inclusive.</td></tr>
  1994. <tr><td class="paramdir">[in]</td><td class="paramname">minute</td><td>Valid range 0 - 59 inclusive.</td></tr>
  1995. <tr><td class="paramdir">[in]</td><td class="paramname">second</td><td>Valid range 0 - 59 inclusive</td></tr>
  1996. </table>
  1997. </dd>
  1998. </dl>
  1999. <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>
  2000. <dd>
  2001. Modify and access timestamps may be overwritten if a date time callback function has been set by dateTimeCallback().</dd></dl>
  2002. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  2003. </div>
  2004. </div>
  2005. <a id="aca37955d3c7cce40f7f9e1ea078e5636"></a>
  2006. <h2 class="memtitle"><span class="permalink"><a href="#aca37955d3c7cce40f7f9e1ea078e5636">&#9670;&nbsp;</a></span>truncate() <span class="overload">[1/2]</span></h2>
  2007. <div class="memitem">
  2008. <div class="memproto">
  2009. <table class="memname">
  2010. <tr>
  2011. <td class="memname">bool ExFatFile::truncate </td>
  2012. <td>(</td>
  2013. <td class="paramname"></td><td>)</td>
  2014. <td></td>
  2015. </tr>
  2016. </table>
  2017. </div><div class="memdoc">
  2018. <p>Truncate a file at 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>
  2019. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  2020. </div>
  2021. </div>
  2022. <a id="a6262b0d6d43d2a426953a0a7d90f624f"></a>
  2023. <h2 class="memtitle"><span class="permalink"><a href="#a6262b0d6d43d2a426953a0a7d90f624f">&#9670;&nbsp;</a></span>truncate() <span class="overload">[2/2]</span></h2>
  2024. <div class="memitem">
  2025. <div class="memproto">
  2026. <table class="mlabels">
  2027. <tr>
  2028. <td class="mlabels-left">
  2029. <table class="memname">
  2030. <tr>
  2031. <td class="memname">bool ExFatFile::truncate </td>
  2032. <td>(</td>
  2033. <td class="paramtype">uint64_t&#160;</td>
  2034. <td class="paramname"><em>length</em></td><td>)</td>
  2035. <td></td>
  2036. </tr>
  2037. </table>
  2038. </td>
  2039. <td class="mlabels-right">
  2040. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2041. </tr>
  2042. </table>
  2043. </div><div class="memdoc">
  2044. <p>Truncate a file to a specified length. The current file position will be set to end of file.</p>
  2045. <dl class="params"><dt>Parameters</dt><dd>
  2046. <table class="params">
  2047. <tr><td class="paramdir">[in]</td><td class="paramname">length</td><td>The desired length for the file.</td></tr>
  2048. </table>
  2049. </dd>
  2050. </dl>
  2051. <dl class="section return"><dt>Returns</dt><dd>true for success or false for failure. </dd></dl>
  2052. </div>
  2053. </div>
  2054. <a id="afc8af11ba8e3a830dff1dd5e59446243"></a>
  2055. <h2 class="memtitle"><span class="permalink"><a href="#afc8af11ba8e3a830dff1dd5e59446243">&#9670;&nbsp;</a></span>validLength()</h2>
  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">uint64_t ExFatFile::validLength </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 valid number of bytes in a file. </dd></dl>
  2076. </div>
  2077. </div>
  2078. <a id="a6fb2905a5e363554a5118b5d1322cd87"></a>
  2079. <h2 class="memtitle"><span class="permalink"><a href="#a6fb2905a5e363554a5118b5d1322cd87">&#9670;&nbsp;</a></span>write() <span class="overload">[1/3]</span></h2>
  2080. <div class="memitem">
  2081. <div class="memproto">
  2082. <table class="mlabels">
  2083. <tr>
  2084. <td class="mlabels-left">
  2085. <table class="memname">
  2086. <tr>
  2087. <td class="memname">size_t ExFatFile::write </td>
  2088. <td>(</td>
  2089. <td class="paramtype">const char *&#160;</td>
  2090. <td class="paramname"><em>str</em></td><td>)</td>
  2091. <td></td>
  2092. </tr>
  2093. </table>
  2094. </td>
  2095. <td class="mlabels-right">
  2096. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2097. </tr>
  2098. </table>
  2099. </div><div class="memdoc">
  2100. <p>Write a string to a file. Used by the Arduino Print class. </p><dl class="params"><dt>Parameters</dt><dd>
  2101. <table class="params">
  2102. <tr><td class="paramdir">[in]</td><td class="paramname">str</td><td>Pointer to the string. Use getWriteError to check for errors. </td></tr>
  2103. </table>
  2104. </dd>
  2105. </dl>
  2106. <dl class="section return"><dt>Returns</dt><dd>count of characters written for success or -1 for failure. </dd></dl>
  2107. </div>
  2108. </div>
  2109. <a id="abc1423c7b550614d1067e7173f8b46a8"></a>
  2110. <h2 class="memtitle"><span class="permalink"><a href="#abc1423c7b550614d1067e7173f8b46a8">&#9670;&nbsp;</a></span>write() <span class="overload">[2/3]</span></h2>
  2111. <div class="memitem">
  2112. <div class="memproto">
  2113. <table class="memname">
  2114. <tr>
  2115. <td class="memname">size_t ExFatFile::write </td>
  2116. <td>(</td>
  2117. <td class="paramtype">const void *&#160;</td>
  2118. <td class="paramname"><em>buf</em>, </td>
  2119. </tr>
  2120. <tr>
  2121. <td class="paramkey"></td>
  2122. <td></td>
  2123. <td class="paramtype">size_t&#160;</td>
  2124. <td class="paramname"><em>count</em>&#160;</td>
  2125. </tr>
  2126. <tr>
  2127. <td></td>
  2128. <td>)</td>
  2129. <td></td><td></td>
  2130. </tr>
  2131. </table>
  2132. </div><div class="memdoc">
  2133. <p>Write data to an open file.</p>
  2134. <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_ex_fat_file.html#a2cb3638069afd2d01b79e5dff1a66f55">sync()</a> is called.</dd></dl>
  2135. <dl class="params"><dt>Parameters</dt><dd>
  2136. <table class="params">
  2137. <tr><td class="paramdir">[in]</td><td class="paramname">buf</td><td>Pointer to the location of the data to be written.</td></tr>
  2138. <tr><td class="paramdir">[in]</td><td class="paramname">count</td><td>Number of bytes to write.</td></tr>
  2139. </table>
  2140. </dd>
  2141. </dl>
  2142. <dl class="section return"><dt>Returns</dt><dd>For success <a class="el" href="class_ex_fat_file.html#a6fb2905a5e363554a5118b5d1322cd87">write()</a> returns the number of bytes written, always <em>count</em>. </dd></dl>
  2143. </div>
  2144. </div>
  2145. <a id="afd011d17d66707623c28927a63f81015"></a>
  2146. <h2 class="memtitle"><span class="permalink"><a href="#afd011d17d66707623c28927a63f81015">&#9670;&nbsp;</a></span>write() <span class="overload">[3/3]</span></h2>
  2147. <div class="memitem">
  2148. <div class="memproto">
  2149. <table class="mlabels">
  2150. <tr>
  2151. <td class="mlabels-left">
  2152. <table class="memname">
  2153. <tr>
  2154. <td class="memname">size_t ExFatFile::write </td>
  2155. <td>(</td>
  2156. <td class="paramtype">uint8_t&#160;</td>
  2157. <td class="paramname"><em>b</em></td><td>)</td>
  2158. <td></td>
  2159. </tr>
  2160. </table>
  2161. </td>
  2162. <td class="mlabels-right">
  2163. <span class="mlabels"><span class="mlabel">inline</span></span> </td>
  2164. </tr>
  2165. </table>
  2166. </div><div class="memdoc">
  2167. <p>Write a single byte. </p><dl class="params"><dt>Parameters</dt><dd>
  2168. <table class="params">
  2169. <tr><td class="paramdir">[in]</td><td class="paramname">b</td><td>The byte to be written. </td></tr>
  2170. </table>
  2171. </dd>
  2172. </dl>
  2173. <dl class="section return"><dt>Returns</dt><dd>+1 for success or zero for failure. </dd></dl>
  2174. </div>
  2175. </div>
  2176. <h2 class="groupheader">Friends And Related Function Documentation</h2>
  2177. <a id="a064869383f7639b113eb0aaf0b84335c"></a>
  2178. <h2 class="memtitle"><span class="permalink"><a href="#a064869383f7639b113eb0aaf0b84335c">&#9670;&nbsp;</a></span>ExFatVolume</h2>
  2179. <div class="memitem">
  2180. <div class="memproto">
  2181. <table class="mlabels">
  2182. <tr>
  2183. <td class="mlabels-left">
  2184. <table class="memname">
  2185. <tr>
  2186. <td class="memname">friend class <a class="el" href="class_ex_fat_volume.html">ExFatVolume</a></td>
  2187. </tr>
  2188. </table>
  2189. </td>
  2190. <td class="mlabels-right">
  2191. <span class="mlabels"><span class="mlabel">friend</span></span> </td>
  2192. </tr>
  2193. </table>
  2194. </div><div class="memdoc">
  2195. <p><a class="el" href="class_ex_fat_volume.html" title="exFAT volume.">ExFatVolume</a> allowed access to private members. </p>
  2196. </div>
  2197. </div>
  2198. <hr/>The documentation for this class was generated from the following files:<ul>
  2199. <li>ArduinoSdFat/libraries/SdFat/src/ExFatLib/<a class="el" href="_ex_fat_file_8h.html">ExFatFile.h</a></li>
  2200. <li>ArduinoSdFat/libraries/SdFat/src/ExFatLib/ExFatFile.cpp</li>
  2201. <li>ArduinoSdFat/libraries/SdFat/src/ExFatLib/ExFatFilePrint.cpp</li>
  2202. <li>ArduinoSdFat/libraries/SdFat/src/ExFatLib/ExFatFileWrite.cpp</li>
  2203. </ul>
  2204. </div><!-- contents -->
  2205. <!-- start footer part -->
  2206. <hr class="footer"/><address class="footer"><small>
  2207. Generated on Fri Dec 6 2019 09:45:12 for SdFat by &#160;<a href="http://www.doxygen.org/index.html">
  2208. <img class="footer" src="doxygen.png" alt="doxygen"/>
  2209. </a> 1.8.16
  2210. </small></address>
  2211. </body>
  2212. </html>