https://wikiti.brandonw.net/index.php?action=history&feed=atom&title=83Plus%3ASoftware%3Ausb8x%2FAsm_Interface%2FMSD%2FFAT_findFileInCluster 2026-04-06T13:14:45Z 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/FAT_findFileInCluster&diff=5088&oldid=prev 2006-08-17T19:22:37Z

<p></p> <p><b>New page</b></p><div>== Synopsis ==<br /> '''Name:''' FAT_findFileInCluster<br /> <br /> '''Minimum usb8x version:''' 0.10<br /> <br /> Gets directory entry for a file/folder in specified directory.<br /> <br /> === Inputs ===<br /> * HL is the starting cluster of the directory to search in (obtained with [[../FAT_getStartingCluster|FAT_getStartingCluster]])<br /> * DE points to the name of a file/directory, 11-character format (obtained with [[../FAT_nameConvertTo11|FAT_nameConvertTo11]] if necessary)<br /> <br /> === Outputs ===<br /> * HL points to the directory entry for the found file/folder<br /> * C set if not found<br /> <br /> === Destroys ===<br /> * AF, BC, DE, HL<br /> <br /> == Notes ==<br /> This works with both file and folder names and is a lower-level way of searching for a file/folder in a directory. It is less likely to be used than [[../FAT_lookupPath|FAT_lookupPath]] or [[../DOS_getDirEntry|DOS_getDirEntry]].<br /> Example code to find &quot;test.txt&quot; in the root directory:<br /> &lt;code&gt;<br /> ld hl,0000h ;0000h is always starting cluster for root directory<br /> ld de,sFilename<br /> U_CALL FAT_findFileInCluster<br /> ...<br /> sFilename: DB &quot;TEST TXT&quot;<br /> &lt;/code&gt;<br /> If you are writing an application, you must copy the strings you use to RAM first, or else usb8x will not be able to see them.<br /> <br /> == See Also ==<br /> * [[../FAT_lookupPath|FAT_lookupPath]] - Find whether specified file/directory exists<br /> * [[../DOS_getDirEntry|DOS_getDirEntry]] - Get directory entry for file/folder in specified directory</div>

Brandonw