Brandonw at 05:00, 9 September 2006

2006-09-09T05:00:59Z

Brandonw at 08:47, 17 August 2006

2006-08-17T08:47:47Z

New page

== 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:
<code>
ld hl,sOldName
ld de,sNewName
U_CALL DOS_renameFileEntry
...
sOldName: DB "/old.txt",0
sNewName: DB "/new.txt",0
</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.

== See Also ==
* [[../FAT_lookupPath|FAT_lookupPath]] - Find whether specified file/directory exists

@@ Line 26: / Line 26: @@
   ...
   sOldName: DB "/old.txt",0
-  sNewName: DB "/new.txt",0
+  sNewName: DB "new.txt",0
 </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.

83Plus:Software:usb8x/Asm Interface/MSD/DOS renameFileEntry - Revision history

Brandonw at 05:00, 9 September 2006

Brandonw at 08:47, 17 August 2006