The Rename(old, new) command moves the file old to the new location new.

The Rename function does not return anything.

The optional argument force controls Rename's behavior when a file named new exists.  If force=false then an error is raised and the renaming does not occur.  This is the default behavior.  If force=true then the file is replaced by the renaming.

If either new or old refers to an open file, it is automatically closed before the move.

If the user does not have permission to perform the operation, an exception is raised.

$\mathrm{FileTools}\left[\mathrm{Text}\right]\left[\mathrm{WriteLine}\right]\left(''testfile''\,''this\; is\; a\; test''\right)$

$15$

$\mathrm{FileTools}\left[\mathrm{Text}\right]\left[\mathrm{Close}\right]\left(''testfile''\right)$

$\mathrm{FileTools}\left[\mathrm{Rename}\right]\left(''testfile''\,''testfile2''\right)$

$\mathrm{FileTools}\left[\mathrm{Text}\right]\left[\mathrm{ReadLine}\right]\left(''testfile''\right)$

Error, (in fopen) file or directory does not exist

$\mathrm{FileTools}\left[\mathrm{Text}\right]\left[\mathrm{ReadLine}\right]\left(''testfile2''\right)$

$''this\; is\; a\; test''$

$\mathrm{FileTools}\left[\mathrm{Remove}\right]\left(''testfile2''\right)$