IB Statements/rename - Revision history

Barb at 22:09, 28 May 2009

2009-05-28T22:09:17Z

← Older revision		Revision as of 22:09, 28 May 2009
Line 1:		Line 1:
	'''RENAME statement'''		'''RENAME statement'''

-	'''Syntax:''' RENAME filename-1 [,DIR=directory-1] ,filename-2 [,DIR=directory-2] [,EXCP=statement-label]	+	'''Syntax:''' RENAME filename-1 [,DIR=directory-1] ,filename-2 [,DIR=directory-2] [,EXCP=statement-label \| NOEXCP]

	'''Discussion:''' The RENAME statement renames a Comet file.		'''Discussion:''' The RENAME statement renames a Comet file.

Badge at 09:27, 20 May 2009

2009-05-20T09:27:22Z

← Older revision		Revision as of 09:27, 20 May 2009
Line 1:		Line 1:
-	RENAME statement	+	'''RENAME statement'''
-	Syntax: RENAME filename-1 [,DIR=directory-1] ,filename-2 [,DIR=directory-2] [,EXCP=statement-label]	+
-	Discussion: The RENAME statement renames a Comet file.	+	'''Syntax:''' RENAME filename-1 [,DIR=directory-1] ,filename-2 [,DIR=directory-2] [,EXCP=statement-label]
		+
		+	'''Discussion:''' The RENAME statement renames a Comet file.
		+
	Filename-1 and directory-1 are the name and Comet directory name respectively of the original file. Filename-2 and directory-2 are the name and Comet directory name respectively of the renamed file.		Filename-1 and directory-1 are the name and Comet directory name respectively of the original file. Filename-2 and directory-2 are the name and Comet directory name respectively of the renamed file.

	Filename-1, directory-1, filename-2, and directory-2 are string values. Each may be a string constant, string variable, string expression, or string function.		Filename-1, directory-1, filename-2, and directory-2 are string values. Each may be a string constant, string variable, string expression, or string function.

-	Note: Directory-1 and directory-2 must be located on the same DOS disk, even though they may be on different DOS directories or subdirectories.	+	'''Note:''' Directory-1 and directory-2 must be located on the same DOS disk, even though they may be on different DOS directories or subdirectories.

-	Example 1: RENAME "TESTFILE",DIR="DSK","ARCHIVE",DIR="SSI",EXCP=9999	+	'''Example 1:''' RENAME "TESTFILE",DIR="DSK","ARCHIVE",DIR="SSI",EXCP=9999

-	The above example renames the file TESTFILE located on Comet directory DSK. Its new name will be ARCHIVE and it will be located on Comet directory SSI (assuming that Comet directories DSK and SSI are located on the same DOS disk). If an exception occurs, the program branches to statement label 9999.	+	The above example renames the file TESTFILE located on Comet directory DSK. Its new name will be ARCHIVE and it will be located on Comet directory SSI (assuming that Comet directories DSK and SSI are located on the same DOS disk). If an exception occurs, the program branches to statement label 9999.
-	Example 2: RENAME FILE1$,,FILE2$	+
		+	'''Example 2:''' RENAME FILE1$,,FILE2$

	This example renames a file using string variables. The file name stored in the string variable FILE1$ is renamed to the value stored in string variable FILE2$. Since no directory names are specified, the directory associated with FILE1$ will be used for FILE2$.		This example renames a file using string variables. The file name stored in the string variable FILE1$ is renamed to the value stored in string variable FILE2$. Since no directory names are specified, the directory associated with FILE1$ will be used for FILE2$.

Badge: New page: RENAME statement Syntax: RENAME filename-1 [,DIR=directory-1] ,filename-2 [,DIR=directory-2] [,EXCP=statement-label] Discussion: The RENAME statement renames a Comet file. Filename-1...

2009-05-20T09:25:57Z

New page: RENAME statement Syntax: RENAME filename-1 [,DIR=directory-1] ,filename-2 [,DIR=directory-2] [,EXCP=statement-label] Discussion: The RENAME statement renames a Comet file. Filename-1...

New page

RENAME statement
Syntax: RENAME filename-1 [,DIR=directory-1] ,filename-2 [,DIR=directory-2] [,EXCP=statement-label]
Discussion: The RENAME statement renames a Comet file.
Filename-1 and directory-1 are the name and Comet directory name respectively of the original file. Filename-2 and directory-2 are the name and Comet directory name respectively of the renamed file.

Filename-1, directory-1, filename-2, and directory-2 are string values. Each may be a string constant, string variable, string expression, or string function.

Note: Directory-1 and directory-2 must be located on the same DOS disk, even though they may be on different DOS directories or subdirectories.

Example 1: RENAME "TESTFILE",DIR="DSK","ARCHIVE",DIR="SSI",EXCP=9999

The above example renames the file TESTFILE located on Comet directory DSK. Its new name will be ARCHIVE and it will be located on Comet directory SSI (assuming that Comet directories DSK and SSI are located on the same DOS disk). If an exception occurs, the program branches to statement label 9999.
Example 2: RENAME FILE1$,,FILE2$

This example renames a file using string variables. The file name stored in the string variable FILE1$ is renamed to the value stored in string variable FILE2$. Since no directory names are specified, the directory associated with FILE1$ will be used for FILE2$.