This function makes an operating system call rename a file on disk. The exact behavior of this function depends on the renaming facility for the operating system.
Gamma> rename("myfile.dat","x/myrenamedfile.dat");
t
Gamma> rename("x/myrenamedfile.dat","myfile.dat");
t
Gamma>
See the GTK: Preparing Plots section of the Log Functions chapter in the Cogent Tools Demo and Tutorials book for an example of this function used in context.