83Plus:Software:usb8x/Asm Interface/MSD/DOS deleteFileEntry
From WikiTI
Jump to navigationJump to search
Synopsis
Name: DOS_deleteFileEntry
Minimum usb8x version: 0.10
Deletes a file or folder along with its contents.
Inputs
- HL is the starting cluster of a directory (obtained with [[../FAT_getStartingCluster|FAT_getStartingCluster]])
- DE points to a filename (11-character format, obtained with [[../FAT_nameConvertTo11|FAT_nameConvertTo11]])
Outputs
- If file, it is deleted; if folder, it along with its contents are also deleted
- C set if problems
Destroys
- AF, BC, DE, HL
Notes
This works with both file and folder names.
Example code to delete "test.txt" in the "folder1" directory:
ld hl,sDirectory
U_CALL FAT_getStartingCluster
push hl
ld hl,sFilename
ld de,OP1 ;used as temporary space
U_CALL FAT_nameConvertTo11
ex de,hl
pop hl
U_CALL DOS_deleteFileEntry
...
sFilename: DB "test.txt",0
sDirectory: DB "/folder1",0
Since the filename ("test.txt") was known, hard-coding "TEST TXT" would have been easier, but this is just an example.
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.
See Also
- [[../FAT_getStartingCluster|FAT_getStartingCluster]] - Get starting cluster of specified directory
- [[../FAT_nameConvertTo11|FAT_nameConvertTo11]] - Convert ASCIIZ name to 11-character format