1
1
Fork 0
mirror of https://github.com/QB64Official/qb64.git synced 2024-09-16 03:54:01 +00:00
qb64/internal/help/NAME.txt
Luke Ceddia b586eafd3b Integrated _BLINEINPUT into regular LINE INPUT for BINARY files
LINE INPUT will now use the faster method if passed a file handle
that has been opened FOR BINARY. As such, the _BLINEINPUT command
has been removed.

qb64.bas now takes advantage of this for reading from '$include files,
at least in Include Manager 1. Some tweaking of internal/source/main.txt
was required to get things into a sane state, so I'm holing off changing
the compiler any further so the auto-builder can make sure everything's
smoothed over.

Note: Everything should still compile as normal; I'm just being overcautious.
2014-07-27 00:06:17 +10:00

33 lines
No EOL
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}}