83Plus:Software:usb8x/Asm Interface/MSD/DOS renameFileEntry: Difference between revisions

From WikiTI
Jump to navigationJump to search
No edit summary
 
mNo edit summary
 
Line 26: Line 26:
  ...
  ...
  sOldName: DB "/old.txt",0
  sOldName: DB "/old.txt",0
  sNewName: DB "/new.txt",0
  sNewName: DB "new.txt",0
</code>
</code>
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.
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.

Latest revision as of 05:00, 9 September 2006

Synopsis

Name: DOS_renameFileEntry

Minimum usb8x version: 0.10

Renames a file or folder.

Inputs

  • HL points to an ASCIIZ string of the old file/directory name, including path (ex. "/test1/test2/RenameMe.txt")
  • DE points to an ASCIIZ string of the new name (ex. "NewName.txt")

Outputs

  • Entry is renamed
  • C set if problems

Destroys

  • AF, BC, DE, HL

Notes

This works with both file and folder names. Example code to rename "old.txt" to "new.txt" in the root directory:

ld hl,sOldName
ld de,sNewName
U_CALL DOS_renameFileEntry
...
sOldName: DB "/old.txt",0
sNewName: DB "new.txt",0

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_lookupPath|FAT_lookupPath]] - Find whether specified file/directory exists