ŒFRENAME Rename component file


The ŒFRENAME function allows you to rename a component file. You must have the correct host access permission to rename the file. If the file is currently tied, the name change will be reflected in the name list returned by ŒFNAMES.

Two alternative syntax forms are supported for ŒFRENAME:

 NEWNAME ŒFRENAME OLDNAME

or

 NEWNAME ŒFRENAME TIENO

OLDNAME is a character vector specifying the file to rename. The name is specified in the same way as for ŒFCREATE. If the name contains a directory-separator character (: / or \), it is treated as a full host path name (including the file extension, by convention .aqf). Otherwise it is treated as basic file name only, optionally preceded by a volume number 0 to 9, separated by one or more spaces from the name. In the latter case, the file is created in the directory 0 to 9 specified (the actual path is set the preferences dialog or ŒMOUNT), and the file extension .aqf is added automatically.

NEWNAME is a character vector specifying the new name of the file, specified in the same way.

The second syntax form is an alternative way to rename a file which has already been tied. TIENO is the tie number on which the file is tied.

Note that the host operating system may not allow you to rename a file across different file systems or physical disks.


Topic: APLX Help : Help on APL language : System Functions & Variables : ŒFRENAME Rename component file
[ Previous | Next | Contents | Index ]