NAME: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
(Created page with "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 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...")
 
No edit summary
Line 23: Line 23:


{{PageSeeAlso}}
{{PageSeeAlso}}
* [[SHELL]], [[MKDIR]], [[FILES]]  
* [[SHELL]], [[MKDIR]], [[FILES]]
* [[CHDIR]], [[KILL]], [[RMDIR]]
* [[CHDIR]], [[KILL]], [[RMDIR]]
* [[Windows_Libraries#File_Dialog_Boxes|Windows Open and Save Dialog Boxes]]
* [[Windows_Libraries#File_Dialog_Boxes|Windows Open and Save Dialog Boxes]]

Revision as of 02:09, 23 January 2023

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 errors are possible and should be handled in the program.
  • Caution: There is no prompt to continue or execution verification.


Examples

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


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link