2
0

class_file.html 34 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603
  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" lang="en-US">
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
  5. <meta http-equiv="X-UA-Compatible" content="IE=11"/>
  6. <meta name="generator" content="Doxygen 1.9.8"/>
  7. <meta name="viewport" content="width=device-width, initial-scale=1"/>
  8. <title>Torque2D Reference: File 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. <link href="t2d-stylesheet-extra.css" rel="stylesheet" type="text/css"/>
  17. </head>
  18. <body>
  19. <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  20. <div id="titlearea">
  21. <table cellspacing="0" cellpadding="0">
  22. <tbody>
  23. <tr id="projectrow">
  24. <td id="projectalign">
  25. <div id="projectname">Torque2D Reference
  26. </div>
  27. </td>
  28. </tr>
  29. </tbody>
  30. </table>
  31. </div>
  32. <!-- end header part -->
  33. <!-- Generated by Doxygen 1.9.8 -->
  34. <script type="text/javascript">
  35. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  36. var searchBox = new SearchBox("searchBox", "search/",'.html');
  37. /* @license-end */
  38. </script>
  39. <script type="text/javascript" src="menudata.js"></script>
  40. <script type="text/javascript" src="menu.js"></script>
  41. <script type="text/javascript">
  42. /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  43. $(function() {
  44. initMenu('',true,false,'search.php','Search');
  45. $(document).ready(function() { init_search(); });
  46. });
  47. /* @license-end */
  48. </script>
  49. <div id="main-nav"></div>
  50. <!-- window showing the filter options -->
  51. <div id="MSearchSelectWindow"
  52. onmouseover="return searchBox.OnSearchSelectShow()"
  53. onmouseout="return searchBox.OnSearchSelectHide()"
  54. onkeydown="return searchBox.OnSearchSelectKey(event)">
  55. </div>
  56. <!-- iframe showing the search results (closed by default) -->
  57. <div id="MSearchResultsWindow">
  58. <div id="MSearchResults">
  59. <div class="SRPage">
  60. <div id="SRIndex">
  61. <div id="SRResults"></div>
  62. <div class="SRStatus" id="Loading">Loading...</div>
  63. <div class="SRStatus" id="Searching">Searching...</div>
  64. <div class="SRStatus" id="NoMatches">No Matches</div>
  65. </div>
  66. </div>
  67. </div>
  68. </div>
  69. </div><!-- top -->
  70. <div class="header">
  71. <div class="summary">
  72. <a href="#pub-types">Public Types</a> &#124;
  73. <a href="#pub-methods">Public Member Functions</a> &#124;
  74. <a href="#pro-methods">Protected Member Functions</a> &#124;
  75. <a href="class_file-members.html">List of all members</a> </div>
  76. <div class="headertitle"><div class="title">File Class Reference</div></div>
  77. </div><!--header-->
  78. <div class="contents">
  79. <p><code>#include &lt;platformFileIO.h&gt;</code></p>
  80. <table class="memberdecls">
  81. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-types" name="pub-types"></a>
  82. Public Types</h2></td></tr>
  83. <tr class="memitem:a67a0db04d321a74b7e7fcfd3f1a3f70b" id="r_a67a0db04d321a74b7e7fcfd3f1a3f70b"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a> { <br />
  84. &#160;&#160;<a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70ba06d32f047358de4e6a30c28046f4688e">Ok</a> = 0
  85. , <a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70ba53ea0cae152133005a5dbe9a1329765c">IOError</a>
  86. , <a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70bae4953b2aea10c683c1f4990a11e01d4d">EOS</a>
  87. , <a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70baa359c7ce2440768125c74d431817548a">IllegalCall</a>
  88. , <br />
  89. &#160;&#160;<a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70ba30c0b4dad1e3a3b93f822b9cef26244b">Closed</a>
  90. , <a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70ba36b13bee92e122caddcb8abefb6eec31">UnknownError</a>
  91. <br />
  92. }</td></tr>
  93. <tr class="memdesc:a67a0db04d321a74b7e7fcfd3f1a3f70b"><td class="mdescLeft">&#160;</td><td class="mdescRight">What is the status of our file handle? <a href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">More...</a><br /></td></tr>
  94. <tr class="separator:a67a0db04d321a74b7e7fcfd3f1a3f70b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  95. <tr class="memitem:ab22d35ed086a478dd91e93ac78037f40" id="r_ab22d35ed086a478dd91e93ac78037f40"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#ab22d35ed086a478dd91e93ac78037f40">AccessMode</a> { <a class="el" href="class_file.html#ab22d35ed086a478dd91e93ac78037f40a809abe96853e69894bbf8e5730b31348">Read</a> = 0
  96. , <a class="el" href="class_file.html#ab22d35ed086a478dd91e93ac78037f40aa56670174817e3fed92bfd8182d7c0d1">Write</a> = 1
  97. , <a class="el" href="class_file.html#ab22d35ed086a478dd91e93ac78037f40a3c4d2d19c91b345c33a83ca9f551f4e1">ReadWrite</a> = 2
  98. , <a class="el" href="class_file.html#ab22d35ed086a478dd91e93ac78037f40a41d36294f7608c7e5565aee5aee6dcf7">WriteAppend</a> = 3
  99. }</td></tr>
  100. <tr class="memdesc:ab22d35ed086a478dd91e93ac78037f40"><td class="mdescLeft">&#160;</td><td class="mdescRight">How are we accessing the file? <a href="class_file.html#ab22d35ed086a478dd91e93ac78037f40">More...</a><br /></td></tr>
  101. <tr class="separator:ab22d35ed086a478dd91e93ac78037f40"><td class="memSeparator" colspan="2">&#160;</td></tr>
  102. <tr class="memitem:a4171335401279aad7e5a463349c093c6" id="r_a4171335401279aad7e5a463349c093c6"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a4171335401279aad7e5a463349c093c6">Capability</a> { <a class="el" href="class_file.html#a4171335401279aad7e5a463349c093c6ad8c3388482873c7d4b65a04d47574fe4">FileRead</a> = BIT(0)
  103. , <a class="el" href="class_file.html#a4171335401279aad7e5a463349c093c6af66a396f05a1ab4fe1cc8d1da442ada4">FileWrite</a> = BIT(1)
  104. }</td></tr>
  105. <tr class="memdesc:a4171335401279aad7e5a463349c093c6"><td class="mdescLeft">&#160;</td><td class="mdescRight">Flags used to indicate what we can do to the file. <a href="class_file.html#a4171335401279aad7e5a463349c093c6">More...</a><br /></td></tr>
  106. <tr class="separator:a4171335401279aad7e5a463349c093c6"><td class="memSeparator" colspan="2">&#160;</td></tr>
  107. </table><table class="memberdecls">
  108. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pub-methods" name="pub-methods"></a>
  109. Public Member Functions</h2></td></tr>
  110. <tr class="memitem:aa2399b233765f85aead662a2f1e67c4b" id="r_aa2399b233765f85aead662a2f1e67c4b"><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#aa2399b233765f85aead662a2f1e67c4b">File</a> ()</td></tr>
  111. <tr class="memdesc:aa2399b233765f85aead662a2f1e67c4b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Default constructor. <br /></td></tr>
  112. <tr class="separator:aa2399b233765f85aead662a2f1e67c4b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  113. <tr class="memitem:a241d694b0e799c0579a023e76cd97f18" id="r_a241d694b0e799c0579a023e76cd97f18"><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a241d694b0e799c0579a023e76cd97f18">~File</a> ()</td></tr>
  114. <tr class="memdesc:a241d694b0e799c0579a023e76cd97f18"><td class="mdescLeft">&#160;</td><td class="mdescRight">Destructor. <br /></td></tr>
  115. <tr class="separator:a241d694b0e799c0579a023e76cd97f18"><td class="memSeparator" colspan="2">&#160;</td></tr>
  116. <tr class="memitem:a1fcc5e785e9af30e2c57e44470308c27" id="r_a1fcc5e785e9af30e2c57e44470308c27"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a1fcc5e785e9af30e2c57e44470308c27">open</a> (const char *filename, const <a class="el" href="class_file.html#ab22d35ed086a478dd91e93ac78037f40">AccessMode</a> openMode)</td></tr>
  117. <tr class="separator:a1fcc5e785e9af30e2c57e44470308c27"><td class="memSeparator" colspan="2">&#160;</td></tr>
  118. <tr class="memitem:ae91252bdbffcafaefaa6edec813a3c1e" id="r_ae91252bdbffcafaefaa6edec813a3c1e"><td class="memItemLeft" align="right" valign="top">U32&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#ae91252bdbffcafaefaa6edec813a3c1e">getPosition</a> () const</td></tr>
  119. <tr class="separator:ae91252bdbffcafaefaa6edec813a3c1e"><td class="memSeparator" colspan="2">&#160;</td></tr>
  120. <tr class="memitem:aa2f33f4be57e484f8eff9f03cbd64715" id="r_aa2f33f4be57e484f8eff9f03cbd64715"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#aa2f33f4be57e484f8eff9f03cbd64715">setPosition</a> (S32 position, bool absolutePos=true)</td></tr>
  121. <tr class="separator:aa2f33f4be57e484f8eff9f03cbd64715"><td class="memSeparator" colspan="2">&#160;</td></tr>
  122. <tr class="memitem:a7cc9594fcf9521b946f5a6af63416042" id="r_a7cc9594fcf9521b946f5a6af63416042"><td class="memItemLeft" align="right" valign="top">U32&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a7cc9594fcf9521b946f5a6af63416042">getSize</a> () const</td></tr>
  123. <tr class="memdesc:a7cc9594fcf9521b946f5a6af63416042"><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns the size of the file. <br /></td></tr>
  124. <tr class="separator:a7cc9594fcf9521b946f5a6af63416042"><td class="memSeparator" colspan="2">&#160;</td></tr>
  125. <tr class="memitem:aaf503c9e2cda620f95c2e0dd263372bd" id="r_aaf503c9e2cda620f95c2e0dd263372bd"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#aaf503c9e2cda620f95c2e0dd263372bd">flush</a> ()</td></tr>
  126. <tr class="separator:aaf503c9e2cda620f95c2e0dd263372bd"><td class="memSeparator" colspan="2">&#160;</td></tr>
  127. <tr class="memitem:a4e7159a54e5554f196e6e56dc50c765b" id="r_a4e7159a54e5554f196e6e56dc50c765b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a4e7159a54e5554f196e6e56dc50c765b">close</a> ()</td></tr>
  128. <tr class="separator:a4e7159a54e5554f196e6e56dc50c765b"><td class="memSeparator" colspan="2">&#160;</td></tr>
  129. <tr class="memitem:abdb27e5cb6f722c6e1dc9f145140feae" id="r_abdb27e5cb6f722c6e1dc9f145140feae"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#abdb27e5cb6f722c6e1dc9f145140feae">getStatus</a> () const</td></tr>
  130. <tr class="memdesc:abdb27e5cb6f722c6e1dc9f145140feae"><td class="mdescLeft">&#160;</td><td class="mdescRight">Gets the status of the file. <br /></td></tr>
  131. <tr class="separator:abdb27e5cb6f722c6e1dc9f145140feae"><td class="memSeparator" colspan="2">&#160;</td></tr>
  132. <tr class="memitem:ac96348f40444e36cfa032bba1dd44b69" id="r_ac96348f40444e36cfa032bba1dd44b69"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#ac96348f40444e36cfa032bba1dd44b69">read</a> (U32 size, char *dst, U32 *bytesRead=NULL)</td></tr>
  133. <tr class="separator:ac96348f40444e36cfa032bba1dd44b69"><td class="memSeparator" colspan="2">&#160;</td></tr>
  134. <tr class="memitem:a1dc73999b04209140aae32a26340f5d8" id="r_a1dc73999b04209140aae32a26340f5d8"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a1dc73999b04209140aae32a26340f5d8">write</a> (U32 size, const char *src, U32 *bytesWritten=NULL)</td></tr>
  135. <tr class="separator:a1dc73999b04209140aae32a26340f5d8"><td class="memSeparator" colspan="2">&#160;</td></tr>
  136. <tr class="memitem:a8c577f07acd90d9c9e11045a1754ce4a" id="r_a8c577f07acd90d9c9e11045a1754ce4a"><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a8c577f07acd90d9c9e11045a1754ce4a">hasCapability</a> (<a class="el" href="class_file.html#a4171335401279aad7e5a463349c093c6">Capability</a> cap) const</td></tr>
  137. <tr class="memdesc:a8c577f07acd90d9c9e11045a1754ce4a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns whether or not this file is capable of the given function. <br /></td></tr>
  138. <tr class="separator:a8c577f07acd90d9c9e11045a1754ce4a"><td class="memSeparator" colspan="2">&#160;</td></tr>
  139. </table><table class="memberdecls">
  140. <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="pro-methods" name="pro-methods"></a>
  141. Protected Member Functions</h2></td></tr>
  142. <tr class="memitem:a33e3229a5b26fa040a6aa2e47d938b4c" id="r_a33e3229a5b26fa040a6aa2e47d938b4c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#a33e3229a5b26fa040a6aa2e47d938b4c">setStatus</a> ()</td></tr>
  143. <tr class="memdesc:a33e3229a5b26fa040a6aa2e47d938b4c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Called after error encountered. <br /></td></tr>
  144. <tr class="separator:a33e3229a5b26fa040a6aa2e47d938b4c"><td class="memSeparator" colspan="2">&#160;</td></tr>
  145. <tr class="memitem:ae1cc73e44fece934f01de9f3f594ae10" id="r_ae1cc73e44fece934f01de9f3f594ae10"><td class="memItemLeft" align="right" valign="top"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_file.html#ae1cc73e44fece934f01de9f3f594ae10">setStatus</a> (<a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a> status)</td></tr>
  146. <tr class="memdesc:ae1cc73e44fece934f01de9f3f594ae10"><td class="mdescLeft">&#160;</td><td class="mdescRight">Setter for the current status. <br /></td></tr>
  147. <tr class="separator:ae1cc73e44fece934f01de9f3f594ae10"><td class="memSeparator" colspan="2">&#160;</td></tr>
  148. </table>
  149. <h2 class="groupheader">Member Enumeration Documentation</h2>
  150. <a id="ab22d35ed086a478dd91e93ac78037f40" name="ab22d35ed086a478dd91e93ac78037f40"></a>
  151. <h2 class="memtitle"><span class="permalink"><a href="#ab22d35ed086a478dd91e93ac78037f40">&#9670;&#160;</a></span>AccessMode</h2>
  152. <div class="memitem">
  153. <div class="memproto">
  154. <table class="memname">
  155. <tr>
  156. <td class="memname">enum <a class="el" href="class_file.html#ab22d35ed086a478dd91e93ac78037f40">AccessMode</a></td>
  157. </tr>
  158. </table>
  159. </div><div class="memdoc">
  160. <p>How are we accessing the file? </p>
  161. <table class="fieldtable">
  162. <tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="ab22d35ed086a478dd91e93ac78037f40a809abe96853e69894bbf8e5730b31348" name="ab22d35ed086a478dd91e93ac78037f40a809abe96853e69894bbf8e5730b31348"></a>Read&#160;</td><td class="fielddoc"><p>Open for read only, starting at beginning of file. </p>
  163. </td></tr>
  164. <tr><td class="fieldname"><a id="ab22d35ed086a478dd91e93ac78037f40aa56670174817e3fed92bfd8182d7c0d1" name="ab22d35ed086a478dd91e93ac78037f40aa56670174817e3fed92bfd8182d7c0d1"></a>Write&#160;</td><td class="fielddoc"><p>Open for write only, starting at beginning of file; will blast old contents of file. </p>
  165. </td></tr>
  166. <tr><td class="fieldname"><a id="ab22d35ed086a478dd91e93ac78037f40a3c4d2d19c91b345c33a83ca9f551f4e1" name="ab22d35ed086a478dd91e93ac78037f40a3c4d2d19c91b345c33a83ca9f551f4e1"></a>ReadWrite&#160;</td><td class="fielddoc"><p>Open for read-write. </p>
  167. </td></tr>
  168. <tr><td class="fieldname"><a id="ab22d35ed086a478dd91e93ac78037f40a41d36294f7608c7e5565aee5aee6dcf7" name="ab22d35ed086a478dd91e93ac78037f40a41d36294f7608c7e5565aee5aee6dcf7"></a>WriteAppend&#160;</td><td class="fielddoc"><p>Write-only, starting at end of file. </p>
  169. </td></tr>
  170. </table>
  171. </div>
  172. </div>
  173. <a id="a4171335401279aad7e5a463349c093c6" name="a4171335401279aad7e5a463349c093c6"></a>
  174. <h2 class="memtitle"><span class="permalink"><a href="#a4171335401279aad7e5a463349c093c6">&#9670;&#160;</a></span>Capability</h2>
  175. <div class="memitem">
  176. <div class="memproto">
  177. <table class="memname">
  178. <tr>
  179. <td class="memname">enum <a class="el" href="class_file.html#a4171335401279aad7e5a463349c093c6">Capability</a></td>
  180. </tr>
  181. </table>
  182. </div><div class="memdoc">
  183. <p>Flags used to indicate what we can do to the file. </p>
  184. <table class="fieldtable">
  185. <tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a4171335401279aad7e5a463349c093c6ad8c3388482873c7d4b65a04d47574fe4" name="a4171335401279aad7e5a463349c093c6ad8c3388482873c7d4b65a04d47574fe4"></a>FileRead&#160;</td><td class="fielddoc"></td></tr>
  186. <tr><td class="fieldname"><a id="a4171335401279aad7e5a463349c093c6af66a396f05a1ab4fe1cc8d1da442ada4" name="a4171335401279aad7e5a463349c093c6af66a396f05a1ab4fe1cc8d1da442ada4"></a>FileWrite&#160;</td><td class="fielddoc"></td></tr>
  187. </table>
  188. </div>
  189. </div>
  190. <a id="a67a0db04d321a74b7e7fcfd3f1a3f70b" name="a67a0db04d321a74b7e7fcfd3f1a3f70b"></a>
  191. <h2 class="memtitle"><span class="permalink"><a href="#a67a0db04d321a74b7e7fcfd3f1a3f70b">&#9670;&#160;</a></span>Status</h2>
  192. <div class="memitem">
  193. <div class="memproto">
  194. <table class="memname">
  195. <tr>
  196. <td class="memname">enum <a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">Status</a></td>
  197. </tr>
  198. </table>
  199. </div><div class="memdoc">
  200. <p>What is the status of our file handle? </p>
  201. <table class="fieldtable">
  202. <tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="a67a0db04d321a74b7e7fcfd3f1a3f70ba06d32f047358de4e6a30c28046f4688e" name="a67a0db04d321a74b7e7fcfd3f1a3f70ba06d32f047358de4e6a30c28046f4688e"></a>Ok&#160;</td><td class="fielddoc"><p>Ok! </p>
  203. </td></tr>
  204. <tr><td class="fieldname"><a id="a67a0db04d321a74b7e7fcfd3f1a3f70ba53ea0cae152133005a5dbe9a1329765c" name="a67a0db04d321a74b7e7fcfd3f1a3f70ba53ea0cae152133005a5dbe9a1329765c"></a>IOError&#160;</td><td class="fielddoc"><p>Read or Write error. </p>
  205. </td></tr>
  206. <tr><td class="fieldname"><a id="a67a0db04d321a74b7e7fcfd3f1a3f70bae4953b2aea10c683c1f4990a11e01d4d" name="a67a0db04d321a74b7e7fcfd3f1a3f70bae4953b2aea10c683c1f4990a11e01d4d"></a>EOS&#160;</td><td class="fielddoc"><p>End of <a class="el" href="class_stream.html" title="Base stream class for streaming data across a specific media.">Stream</a> reached (mostly for reads) </p>
  207. </td></tr>
  208. <tr><td class="fieldname"><a id="a67a0db04d321a74b7e7fcfd3f1a3f70baa359c7ce2440768125c74d431817548a" name="a67a0db04d321a74b7e7fcfd3f1a3f70baa359c7ce2440768125c74d431817548a"></a>IllegalCall&#160;</td><td class="fielddoc"><p>An unsupported operation used. Always accompanied by AssertWarn. </p>
  209. </td></tr>
  210. <tr><td class="fieldname"><a id="a67a0db04d321a74b7e7fcfd3f1a3f70ba30c0b4dad1e3a3b93f822b9cef26244b" name="a67a0db04d321a74b7e7fcfd3f1a3f70ba30c0b4dad1e3a3b93f822b9cef26244b"></a>Closed&#160;</td><td class="fielddoc"><p>Tried to operate on a closed stream (or detached filter) </p>
  211. </td></tr>
  212. <tr><td class="fieldname"><a id="a67a0db04d321a74b7e7fcfd3f1a3f70ba36b13bee92e122caddcb8abefb6eec31" name="a67a0db04d321a74b7e7fcfd3f1a3f70ba36b13bee92e122caddcb8abefb6eec31"></a>UnknownError&#160;</td><td class="fielddoc"><p>Catchall. </p>
  213. </td></tr>
  214. </table>
  215. </div>
  216. </div>
  217. <h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
  218. <a id="aa2399b233765f85aead662a2f1e67c4b" name="aa2399b233765f85aead662a2f1e67c4b"></a>
  219. <h2 class="memtitle"><span class="permalink"><a href="#aa2399b233765f85aead662a2f1e67c4b">&#9670;&#160;</a></span>File()</h2>
  220. <div class="memitem">
  221. <div class="memproto">
  222. <table class="memname">
  223. <tr>
  224. <td class="memname"><a class="el" href="class_file.html">File</a> </td>
  225. <td>(</td>
  226. <td class="paramname"></td><td>)</td>
  227. <td></td>
  228. </tr>
  229. </table>
  230. </div><div class="memdoc">
  231. <p>Default constructor. </p>
  232. </div>
  233. </div>
  234. <a id="a241d694b0e799c0579a023e76cd97f18" name="a241d694b0e799c0579a023e76cd97f18"></a>
  235. <h2 class="memtitle"><span class="permalink"><a href="#a241d694b0e799c0579a023e76cd97f18">&#9670;&#160;</a></span>~File()</h2>
  236. <div class="memitem">
  237. <div class="memproto">
  238. <table class="mlabels">
  239. <tr>
  240. <td class="mlabels-left">
  241. <table class="memname">
  242. <tr>
  243. <td class="memname">~<a class="el" href="class_file.html">File</a> </td>
  244. <td>(</td>
  245. <td class="paramname"></td><td>)</td>
  246. <td></td>
  247. </tr>
  248. </table>
  249. </td>
  250. <td class="mlabels-right">
  251. <span class="mlabels"><span class="mlabel">virtual</span></span> </td>
  252. </tr>
  253. </table>
  254. </div><div class="memdoc">
  255. <p>Destructor. </p>
  256. </div>
  257. </div>
  258. <h2 class="groupheader">Member Function Documentation</h2>
  259. <a id="a4e7159a54e5554f196e6e56dc50c765b" name="a4e7159a54e5554f196e6e56dc50c765b"></a>
  260. <h2 class="memtitle"><span class="permalink"><a href="#a4e7159a54e5554f196e6e56dc50c765b">&#9670;&#160;</a></span>close()</h2>
  261. <div class="memitem">
  262. <div class="memproto">
  263. <table class="memname">
  264. <tr>
  265. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> close </td>
  266. <td>(</td>
  267. <td class="paramname"></td><td>)</td>
  268. <td></td>
  269. </tr>
  270. </table>
  271. </div><div class="memdoc">
  272. <p>Closes the file</p>
  273. <dl class="section return"><dt>Returns</dt><dd>The status of the file. </dd></dl>
  274. </div>
  275. </div>
  276. <a id="aaf503c9e2cda620f95c2e0dd263372bd" name="aaf503c9e2cda620f95c2e0dd263372bd"></a>
  277. <h2 class="memtitle"><span class="permalink"><a href="#aaf503c9e2cda620f95c2e0dd263372bd">&#9670;&#160;</a></span>flush()</h2>
  278. <div class="memitem">
  279. <div class="memproto">
  280. <table class="memname">
  281. <tr>
  282. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> flush </td>
  283. <td>(</td>
  284. <td class="paramname"></td><td>)</td>
  285. <td></td>
  286. </tr>
  287. </table>
  288. </div><div class="memdoc">
  289. <p>Make sure everything that's supposed to be written to the file gets written.</p>
  290. <dl class="section return"><dt>Returns</dt><dd>The status of the file. </dd></dl>
  291. </div>
  292. </div>
  293. <a id="ae91252bdbffcafaefaa6edec813a3c1e" name="ae91252bdbffcafaefaa6edec813a3c1e"></a>
  294. <h2 class="memtitle"><span class="permalink"><a href="#ae91252bdbffcafaefaa6edec813a3c1e">&#9670;&#160;</a></span>getPosition()</h2>
  295. <div class="memitem">
  296. <div class="memproto">
  297. <table class="memname">
  298. <tr>
  299. <td class="memname">U32 getPosition </td>
  300. <td>(</td>
  301. <td class="paramname"></td><td>)</td>
  302. <td> const</td>
  303. </tr>
  304. </table>
  305. </div><div class="memdoc">
  306. <p>Gets the current position in the file</p>
  307. <p>This is in bytes from the beginning of the file. </p>
  308. </div>
  309. </div>
  310. <a id="a7cc9594fcf9521b946f5a6af63416042" name="a7cc9594fcf9521b946f5a6af63416042"></a>
  311. <h2 class="memtitle"><span class="permalink"><a href="#a7cc9594fcf9521b946f5a6af63416042">&#9670;&#160;</a></span>getSize()</h2>
  312. <div class="memitem">
  313. <div class="memproto">
  314. <table class="memname">
  315. <tr>
  316. <td class="memname">U32 getSize </td>
  317. <td>(</td>
  318. <td class="paramname"></td><td>)</td>
  319. <td> const</td>
  320. </tr>
  321. </table>
  322. </div><div class="memdoc">
  323. <p>Returns the size of the file. </p>
  324. </div>
  325. </div>
  326. <a id="abdb27e5cb6f722c6e1dc9f145140feae" name="abdb27e5cb6f722c6e1dc9f145140feae"></a>
  327. <h2 class="memtitle"><span class="permalink"><a href="#abdb27e5cb6f722c6e1dc9f145140feae">&#9670;&#160;</a></span>getStatus()</h2>
  328. <div class="memitem">
  329. <div class="memproto">
  330. <table class="memname">
  331. <tr>
  332. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> getStatus </td>
  333. <td>(</td>
  334. <td class="paramname"></td><td>)</td>
  335. <td> const</td>
  336. </tr>
  337. </table>
  338. </div><div class="memdoc">
  339. <p>Gets the status of the file. </p>
  340. </div>
  341. </div>
  342. <a id="a8c577f07acd90d9c9e11045a1754ce4a" name="a8c577f07acd90d9c9e11045a1754ce4a"></a>
  343. <h2 class="memtitle"><span class="permalink"><a href="#a8c577f07acd90d9c9e11045a1754ce4a">&#9670;&#160;</a></span>hasCapability()</h2>
  344. <div class="memitem">
  345. <div class="memproto">
  346. <table class="memname">
  347. <tr>
  348. <td class="memname">bool hasCapability </td>
  349. <td>(</td>
  350. <td class="paramtype"><a class="el" href="class_file.html#a4171335401279aad7e5a463349c093c6">Capability</a>&#160;</td>
  351. <td class="paramname"><em>cap</em></td><td>)</td>
  352. <td> const</td>
  353. </tr>
  354. </table>
  355. </div><div class="memdoc">
  356. <p>Returns whether or not this file is capable of the given function. </p>
  357. </div>
  358. </div>
  359. <a id="a1fcc5e785e9af30e2c57e44470308c27" name="a1fcc5e785e9af30e2c57e44470308c27"></a>
  360. <h2 class="memtitle"><span class="permalink"><a href="#a1fcc5e785e9af30e2c57e44470308c27">&#9670;&#160;</a></span>open()</h2>
  361. <div class="memitem">
  362. <div class="memproto">
  363. <table class="memname">
  364. <tr>
  365. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> open </td>
  366. <td>(</td>
  367. <td class="paramtype">const char *&#160;</td>
  368. <td class="paramname"><em>filename</em>, </td>
  369. </tr>
  370. <tr>
  371. <td class="paramkey"></td>
  372. <td></td>
  373. <td class="paramtype">const <a class="el" href="class_file.html#ab22d35ed086a478dd91e93ac78037f40">AccessMode</a>&#160;</td>
  374. <td class="paramname"><em>openMode</em>&#160;</td>
  375. </tr>
  376. <tr>
  377. <td></td>
  378. <td>)</td>
  379. <td></td><td></td>
  380. </tr>
  381. </table>
  382. </div><div class="memdoc">
  383. <p>Opens a file for access using the specified AccessMode</p>
  384. <dl class="section return"><dt>Returns</dt><dd>The status of the file </dd></dl>
  385. </div>
  386. </div>
  387. <a id="ac96348f40444e36cfa032bba1dd44b69" name="ac96348f40444e36cfa032bba1dd44b69"></a>
  388. <h2 class="memtitle"><span class="permalink"><a href="#ac96348f40444e36cfa032bba1dd44b69">&#9670;&#160;</a></span>read()</h2>
  389. <div class="memitem">
  390. <div class="memproto">
  391. <table class="memname">
  392. <tr>
  393. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> read </td>
  394. <td>(</td>
  395. <td class="paramtype">U32&#160;</td>
  396. <td class="paramname"><em>size</em>, </td>
  397. </tr>
  398. <tr>
  399. <td class="paramkey"></td>
  400. <td></td>
  401. <td class="paramtype">char *&#160;</td>
  402. <td class="paramname"><em>dst</em>, </td>
  403. </tr>
  404. <tr>
  405. <td class="paramkey"></td>
  406. <td></td>
  407. <td class="paramtype">U32 *&#160;</td>
  408. <td class="paramname"><em>bytesRead</em> = <code>NULL</code>&#160;</td>
  409. </tr>
  410. <tr>
  411. <td></td>
  412. <td>)</td>
  413. <td></td><td></td>
  414. </tr>
  415. </table>
  416. </div><div class="memdoc">
  417. <p>Reads "size" bytes from the file, and dumps data into "dst". The number of actual bytes read is returned in bytesRead </p><dl class="section return"><dt>Returns</dt><dd>The status of the file </dd></dl>
  418. </div>
  419. </div>
  420. <a id="aa2f33f4be57e484f8eff9f03cbd64715" name="aa2f33f4be57e484f8eff9f03cbd64715"></a>
  421. <h2 class="memtitle"><span class="permalink"><a href="#aa2f33f4be57e484f8eff9f03cbd64715">&#9670;&#160;</a></span>setPosition()</h2>
  422. <div class="memitem">
  423. <div class="memproto">
  424. <table class="memname">
  425. <tr>
  426. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> setPosition </td>
  427. <td>(</td>
  428. <td class="paramtype">S32&#160;</td>
  429. <td class="paramname"><em>position</em>, </td>
  430. </tr>
  431. <tr>
  432. <td class="paramkey"></td>
  433. <td></td>
  434. <td class="paramtype">bool&#160;</td>
  435. <td class="paramname"><em>absolutePos</em> = <code>true</code>&#160;</td>
  436. </tr>
  437. <tr>
  438. <td></td>
  439. <td>)</td>
  440. <td></td><td></td>
  441. </tr>
  442. </table>
  443. </div><div class="memdoc">
  444. <p>Sets the current position in the file.</p>
  445. <p>You can set either a relative or absolute position to go to in the file.</p>
  446. <div class="fragment"><div class="line"><a class="code hl_class" href="class_file.html">File</a> *foo;</div>
  447. <div class="line"> </div>
  448. <div class="line">... set up file ...</div>
  449. <div class="line"> </div>
  450. <div class="line"><span class="comment">// Go to byte 32 in the file...</span></div>
  451. <div class="line">foo-&gt;setPosition(32);</div>
  452. <div class="line"> </div>
  453. <div class="line"><span class="comment">// Now skip back 20 bytes...</span></div>
  454. <div class="line">foo-&gt;<a class="code hl_function" href="class_file.html#aa2f33f4be57e484f8eff9f03cbd64715">setPosition</a>(-20, <span class="keyword">false</span>);</div>
  455. <div class="line"> </div>
  456. <div class="line"><span class="comment">// And forward 17...</span></div>
  457. <div class="line">foo-&gt;<a class="code hl_function" href="class_file.html#aa2f33f4be57e484f8eff9f03cbd64715">setPosition</a>(17, <span class="keyword">false</span>);</div>
  458. <div class="ttc" id="aclass_file_html"><div class="ttname"><a href="class_file.html">File</a></div><div class="ttdef"><b>Definition</b> platformFileIO.h:35</div></div>
  459. <div class="ttc" id="aclass_file_html_aa2f33f4be57e484f8eff9f03cbd64715"><div class="ttname"><a href="class_file.html#aa2f33f4be57e484f8eff9f03cbd64715">File::setPosition</a></div><div class="ttdeci">Status setPosition(S32 position, bool absolutePos=true)</div><div class="ttdef"><b>Definition</b> AndroidFileio.cpp:314</div></div>
  460. </div><!-- fragment --><dl class="section return"><dt>Returns</dt><dd>The status of the file </dd></dl>
  461. </div>
  462. </div>
  463. <a id="a33e3229a5b26fa040a6aa2e47d938b4c" name="a33e3229a5b26fa040a6aa2e47d938b4c"></a>
  464. <h2 class="memtitle"><span class="permalink"><a href="#a33e3229a5b26fa040a6aa2e47d938b4c">&#9670;&#160;</a></span>setStatus() <span class="overload">[1/2]</span></h2>
  465. <div class="memitem">
  466. <div class="memproto">
  467. <table class="mlabels">
  468. <tr>
  469. <td class="mlabels-left">
  470. <table class="memname">
  471. <tr>
  472. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> setStatus </td>
  473. <td>(</td>
  474. <td class="paramname"></td><td>)</td>
  475. <td></td>
  476. </tr>
  477. </table>
  478. </td>
  479. <td class="mlabels-right">
  480. <span class="mlabels"><span class="mlabel">protected</span></span> </td>
  481. </tr>
  482. </table>
  483. </div><div class="memdoc">
  484. <p>Called after error encountered. </p>
  485. </div>
  486. </div>
  487. <a id="ae1cc73e44fece934f01de9f3f594ae10" name="ae1cc73e44fece934f01de9f3f594ae10"></a>
  488. <h2 class="memtitle"><span class="permalink"><a href="#ae1cc73e44fece934f01de9f3f594ae10">&#9670;&#160;</a></span>setStatus() <span class="overload">[2/2]</span></h2>
  489. <div class="memitem">
  490. <div class="memproto">
  491. <table class="mlabels">
  492. <tr>
  493. <td class="mlabels-left">
  494. <table class="memname">
  495. <tr>
  496. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> setStatus </td>
  497. <td>(</td>
  498. <td class="paramtype"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a>&#160;</td>
  499. <td class="paramname"><em>status</em></td><td>)</td>
  500. <td></td>
  501. </tr>
  502. </table>
  503. </td>
  504. <td class="mlabels-right">
  505. <span class="mlabels"><span class="mlabel">protected</span></span> </td>
  506. </tr>
  507. </table>
  508. </div><div class="memdoc">
  509. <p>Setter for the current status. </p>
  510. </div>
  511. </div>
  512. <a id="a1dc73999b04209140aae32a26340f5d8" name="a1dc73999b04209140aae32a26340f5d8"></a>
  513. <h2 class="memtitle"><span class="permalink"><a href="#a1dc73999b04209140aae32a26340f5d8">&#9670;&#160;</a></span>write()</h2>
  514. <div class="memitem">
  515. <div class="memproto">
  516. <table class="memname">
  517. <tr>
  518. <td class="memname"><a class="el" href="class_file.html#a67a0db04d321a74b7e7fcfd3f1a3f70b">File::Status</a> write </td>
  519. <td>(</td>
  520. <td class="paramtype">U32&#160;</td>
  521. <td class="paramname"><em>size</em>, </td>
  522. </tr>
  523. <tr>
  524. <td class="paramkey"></td>
  525. <td></td>
  526. <td class="paramtype">const char *&#160;</td>
  527. <td class="paramname"><em>src</em>, </td>
  528. </tr>
  529. <tr>
  530. <td class="paramkey"></td>
  531. <td></td>
  532. <td class="paramtype">U32 *&#160;</td>
  533. <td class="paramname"><em>bytesWritten</em> = <code>NULL</code>&#160;</td>
  534. </tr>
  535. <tr>
  536. <td></td>
  537. <td>)</td>
  538. <td></td><td></td>
  539. </tr>
  540. </table>
  541. </div><div class="memdoc">
  542. <p>Writes "size" bytes into the file from the pointer "src". The number of actual bytes written is returned in bytesWritten </p><dl class="section return"><dt>Returns</dt><dd>The status of the file </dd></dl>
  543. </div>
  544. </div>
  545. <hr/>The documentation for this class was generated from the following files:<ul>
  546. <li>platform/<b>platformFileIO.h</b></li>
  547. <li>platformAndroid/<b>AndroidFileio.cpp</b></li>
  548. <li>platformEmscripten/<b>EmscriptenFileio.cpp</b></li>
  549. </ul>
  550. </div><!-- contents -->
  551. <!-- start footer part -->
  552. <hr class="footer"/><address class="footer"><small>
  553. Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.8
  554. </small></address>
  555. </body>
  556. </html>