君RENAME Change the name of a native file


The 君RENAME function allows you to rename a file in the host file system. 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 君NAMES.

Two alternative syntax forms are supported for 君RENAME :

          'NEWNAME' 君RENAME 'OLDNAME'
or
          'NEWNAME' 君RENAME TIENO

'OLDNAME' is a character vector specifying the file to rename. The name may be either a full host path name, or the path may be omitted in which case the file to be renamed must be located in the current working directory.

'NEWNAME' is a character vector specifying the new name of the file.

TIENO: 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.

Special considerations for Client-Server implementations of APLX

See 君CREATE for the conventions applying to file locations in Client-Server versions of APLX.


Topic: APLX Help : Help on APL language : System Functions & Variables : 君RENAME Rename native file
[ Previous | Next | Contents | Index ]