Site Tools


#$EPIC: rename.txt,v 1.4 2007/03/02 02:32:04 jnelson Exp $


$rename(<oldpath> <newpath>)


  • The <oldpath> and <newpath> arguments are dwords which is different than most functions.
  • If the <oldpath> or <newpath> arguments are omitted this function returns the empty string.
  • The file <oldpath> is renamed to <newpath> in accordance with the rename(2) system call on your operating system.
  • Generally speaking $rename() cannot move files between file systems, but they can be moved between directories on the same file system.


Naturally, this function is useful any time a file needs to be renamed. One use for it might be to back up your .ircrc before doing a SAVE, just in case something goes wrong before the command is completed.


 0   file renamed successfully
-1   error during rename attempt


$rename(~/.ircrc ~/.ircrc.bak)              returns 0 if successful
$rename(/etc/passwd /etc/hahaha)            probably will return -1


This function first appeared in EPIC2.

rename.txt · Last modified: 2007/03/02 02:32 by

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki