mirror of
https://github.com/QB64Official/qb64.git
synced 2024-08-22 02:05:08 +00:00
30 lines
1.1 KiB
Text
30 lines
1.1 KiB
Text
The [[NAME]] statement changes the name of a file or directory to a new name.
|
|
|
|
|
|
|
|
{{PageSyntax}}
|
|
: [[NAME]] {{Parameter|oldFileOrFolderName$}} '''AS''' {{Parameter|newFileOrFolderName$}}
|
|
|
|
|
|
{{PageDescription}}
|
|
* {{Parameter|oldFileOrFolderName$}} and {{Parameter|newFileOrFolderName$}} are variables or literal [[STRING]]s 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|errors]] are possible and should be handled in the program.
|
|
* '''Caution: There is no prompt to continue or execution verification.'''
|
|
|
|
|
|
{{PageExamples}}
|
|
{{CodeStart}}
|
|
{{Cl|NAME}} "BIGBAD.TXT" {{Cl|AS}} "BADWOLF.TXT"
|
|
{{CodeEnd}}
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[SHELL]], [[MKDIR]], [[FILES]]
|
|
* [[CHDIR]], [[KILL]], [[RMDIR]]
|
|
* [[Windows_Libraries#File_Dialog_Boxes|Windows Open and Save Dialog Boxes]]
|
|
|
|
|
|
{{PageNavigation}}
|