[ Operating System | Reference Manual | Alphabetic Index ]

rename(+OldName, +NewName)

Renames the file OldName to NewName.
OldName
String or atom.
NewName
String or atom.

Description

OldName and NewName are absolute or relative pathnames of files. Used to rename the file OldName with the name NewName.

Modes and Determinism

Exceptions

(4) instantiation fault
Either OldName or NewName are not instantiated.
(5) type error
Either OldName or NewName are neither a string nor an atom.
(190) end of file reached
File OldName does not exist.

Examples

Success:
      [eclipse]: sh('ls file1').
      file1
      [eclipse]: rename(file1, file2).
      yes.
      [eclipse]: sh('ls file1 file2').
      file1 not found
      file2
      yes.

Error:
      rename(Old, any).             (Error 4).
      rename(any, New).             (Error 4).
      rename(1, any).               (Error 5).
      rename(notfile, newfile).     (Error 190).

See Also

exists / 1, delete / 1, mkdir / 1