RENAME

Portability Function: Renames a file.

Module: USE DFPORT

Syntax

result = RENAME (from, to)

from
(Input) Character*(*). Path of an existing file.

to
(Input) Character*(*). The new path (see Warning below).

Results:

The result is of type INTEGER(4). The result is zero if successful; otherwise, an error code, such as:

EACCES: File or directory specified by to could not be created (invalid path). This error is also returned if the drive specified is not currently connected to a device.
ENOENT: File or path specified by from could not be found.
EXDEV: Attempt to move a file to a different device.

Warning: This routine can cause data to be lost. If the file specified in to already exists, RENAME deletes the pre-existing file.

It is possible to rename a file to itself without error.

The paths can use forward (/) or backward (\) slashes as path separators and can include drive letters.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also: RENAMEFILEQQ

Example

 use dfport
 integer(4) istatus
 character*12 old_name, new_name
 print *, "Enter file to rename: "
 read *, old_name
 print *, "Enter new name: "
 read *, new_name
 ISTATUS = RENAME (old_name, new_name)