mirror of
https://github.com/QB64Official/qb64.git
synced 2024-09-02 00:30:17 +00:00
33 lines
1.1 KiB
Text
33 lines
1.1 KiB
Text
|
The '''NAME''' statement changes the name of a file or directory to a new name.
|
||
|
|
||
|
|
||
|
|
||
|
{{PageSyntax}}
|
||
|
:: NAME ''old_filename$'' AS ''new_filename$''
|
||
|
|
||
|
|
||
|
{{PageDescription}}
|
||
|
* Filenames are variables or literal [[STRING]]s in quotes. Paths can be included.
|
||
|
* Long filenames can be used in QB64 only! Qbasic requires the DOS 8.3 (folder maximum of 8) naming convention.
|
||
|
* 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$ in DOS.
|
||
|
* 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}}
|
||
|
|
||
|
|
||
|
''See also:''
|
||
|
* [[SHELL]], [[MKDIR]], [[FILES]]
|
||
|
* [[CHDIR]], [[KILL]], [[RMDIR]]
|
||
|
* [[DOS]], [[Batch Files]]
|
||
|
* [[Windows_Libraries#File_Dialog_Boxes|Windows Open and Save Dialog Boxes]]
|
||
|
|
||
|
|
||
|
{{PageNavigation}}
|