C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
rename
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The rename function renames the file or directory specified by
     <oldname> to the name given by <newname>. The old name must be the
     path name of an existing file or directory. The new name must not
     be the name of an existing file or directory.
 
     The rename function can be used to move a file from one directory
     to another by giving a different path name in the <newname>
     argument. However, files cannot be moved from one device to
     another (for example, from drive A to drive B). Directories can
     only be renamed, not moved.
 
     Return Value
 
     The rename function returns 0 if it is successful. On error, it
     returns a nonzero value and sets errno to EACCES, ENOENT, or
     EXDEV.
                                    -♦-