The NAME statement changes the name of a file or directory to a new name.

Syntax

NAME oldFileOrFolderName$ AS newFileOrFolderName$

Description

• oldFileOrFolderName$ and newFileOrFolderName$ are variables or literal STRINGs in quotes. Paths can be included.
• If the two paths are different, the statement moves the original file to the new path and renames it.
• If the path is the same or a path is not included, the original file is just renamed.
• SHELL can use “REN “ + filename$ + “ “ + newname$ for the same purpose (Windows).
• Path or filename ERROR Codes are possible and should be handled in the program.
• Caution: There is no prompt to continue or execution verification.

Example(s)

NAME "BIGBAD.TXT" AS "BADWOLF.TXT"

See Also

• SHELL, MKDIR, FILES
• CHDIR, KILL, RMDIR
• Windows Libraries