https://wikiti.brandonw.net/index.php?action=history&feed=atom&title=83Plus%3ASoftware%3Ausb8x%2FAsm_Interface%2FMSD%2FDOS_openFile 83Plus:Software:usb8x/Asm Interface/MSD/DOS openFile - Revision history 2026-04-06T09:29:06Z Revision history for this page on the wiki MediaWiki 1.23.5 https://wikiti.brandonw.net/index.php?title=83Plus:Software:usb8x/Asm_Interface/MSD/DOS_openFile&diff=5073&oldid=prev Brandonw at 09:26, 17 August 2006 2006-08-17T09:26:48Z <p></p> <table class='diff diff-contentalign-left'> <col class='diff-marker' /> <col class='diff-content' /> <col class='diff-marker' /> <col class='diff-content' /> <tr style='vertical-align: top;'> <td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td> <td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 09:26, 17 August 2006</td> </tr><tr><td colspan="2" class="diff-lineno">Line 11:</td> <td colspan="2" class="diff-lineno">Line 11:</td></tr> <tr><td class='diff-marker'>&#160;</td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'>&#160;</td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"></td></tr> <tr><td class='diff-marker'>&#160;</td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>=== Outputs ===</div></td><td class='diff-marker'>&#160;</td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>=== Outputs ===</div></td></tr> <tr><td colspan="2">&#160;</td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">* File handle is populated and seek pointer is set to offset 0</ins></div></td></tr> <tr><td class='diff-marker'>&#160;</td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* HL points to the file handle</div></td><td class='diff-marker'>&#160;</td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* HL points to the file handle</div></td></tr> <tr><td class='diff-marker'>&#160;</td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* C set if problems</div></td><td class='diff-marker'>&#160;</td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>* C set if problems</div></td></tr> </table> Brandonw https://wikiti.brandonw.net/index.php?title=83Plus:Software:usb8x/Asm_Interface/MSD/DOS_openFile&diff=5054&oldid=prev Brandonw at 08:03, 17 August 2006 2006-08-17T08:03:11Z <p></p> <p><b>New page</b></p><div>== Synopsis ==<br /> '''Name:''' DOS_openFile<br /> <br /> '''Minimum usb8x version:''' 0.10<br /> <br /> Opens a file for reading or writing by populating a file handle containing important information.<br /> <br /> === Inputs ===<br /> * HL points to ASCIIZ filename including path (ex. &quot;/TESTDIR/TEST.TXT&quot;,0)<br /> * DE points to a location to store the file handle (typically 27 bytes, size obtained by [[../MSDVersion|MSDVersion]])<br /> <br /> === Outputs ===<br /> * HL points to the file handle<br /> * C set if problems<br /> <br /> === Destroys ===<br /> * AF, BC, DE, HL<br /> <br /> == Notes ==<br /> The filename is case-insensitive. There is also no &quot;closing&quot; a file. The file handle can be discarded when no more reading/writing is required.<br /> Example code to open &quot;README.TXT&quot; for reading/writing (storing file handle to statVars):<br /> &lt;code&gt;<br /> ld hl,sFilename<br /> ld de,statVars<br /> U_CALL DOS_openFile<br /> jr c,openFileError<br /> ;HL points to file handle<br /> ...<br /> openFileError:<br /> ...<br /> sFilename: DB &quot;/TESTDIR/README.TXT&quot;,0<br /> &lt;/code&gt;<br /> <br /> == See Also ==<br /> * [[../DOS_fileSeek|DOS_fileSeek]] - Set seek pointer of file handle<br /> * [[../DOS_fileRead|DOS_fileRead]] - Read bytes from a file<br /> * [[../DOS_fileWrite|DOS_fileWrite]] - Write bytes to a file</div> Brandonw