Intel® Fortran Libraries Reference

2 Intel Fortran Libraries ReferenceRENAMEPortability Function: Renames a file.Module: USE IFPORTSyntaxresult = RENAME (from, to)from(Input) Character*(*). Path of an existing file.to(Input) Character*(*). The new path for the file (see Caution note below).Results:The result type is INTEGER(4). The result is zero if successful; otherwise, an error code, such as:• EACCES – The file or directory specified by to could not be created (invalid path). This erroris also returned if the drive specified is not currently connected to a device.• ENOENT – The file or path specified by from could not be found.• EXDEV – Attempt to move a file to a different device.CAUTION. 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 driveletters (if permitted by your operating system).CompatibilityCONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIBSee Also: “RENAMEFILEQQ”RENAMEFILEQQPortability Function: Renames a file.Module: USE IFPORTSyntaxresult = RENAMEFILEQQ (oldname, newname)2-376