1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-26 08:35:52 +00:00
QB64-PE/internal/help/NAME.txt
SMcNeill 6e01fc8dce Altered string compare routines (<,<=,>,>=) so they don't give false results with CHR$(0).
Added new _STRCMP and _STRICMP commands for quick string comparisons.
Cleaned up QB64 to finish removing the QUI (quick user insert) code and folders.
Altered UCASE and LCASE routines to be faster in some situations for us.
2014-09-22 08:19:03 -04:00

33 lines
1.1 KiB
Plaintext

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 &quot;REN &quot; + filename$ + &quot; &quot; 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}} &quot;BIGBAD.TXT&quot; {{Cl|AS}} &quot;BADWOLF.TXT&quot;
{{CodeEnd}}
''See also:''
* [[SHELL]], [[MKDIR]], [[FILES]]
* [[CHDIR]], [[KILL]], [[RMDIR]]
* [[DOS]], [[Batch Files]]
* [[Windows_Libraries#File_Dialog_Boxes|Windows Open and Save Dialog Boxes]]
{{PageNavigation}}